Lists

Allow and block lists control who a cell may message, by direction and list type.

Organization

Parent

Cell

Parent

List

This guide

Direction × type

Each list is a matrix of inbound/outbound and allow/block. Org-level lists can apply across cells; cell lists are local.

Direction	Allow	Block
Inbound	Only listed numbers can reach the cell	Listed numbers are rejected
Outbound	Agent may only send to listed numbers	Listed numbers cannot be sent to

await agentcell.lists.add({ cellId, direction: "outbound", type: "allow", phoneNumber: "+14155550144" });

Ignore lists are separate

STOP / opt-out uses ignore lists, not allow/block lists.

Ignore lists guide

Common errors

VALIDATION_ERROR
Invalid direction or type.

Copy for Cursor / Claude

Allow outbound only to a known number.

curl -X POST https://api.agentcell.store/v1/cells/$CELL_ID/lists \
  -H "Authorization: Bearer $AGENTCELL_API_KEY" \
  -d '{"direction":"outbound","type":"allow","phone_number":"+14155550144"}'