Cells

A cell is a dedicated phone identity for your agent: one phone, one SIM, one E.164 number, with its own message history.

Organization

Parent

Pod

Parent

Cell

This guide

Create a cell

A cell is a hosted phone identity (phone + SIM + number) after a handset claims. area_code is a preference string, not a shoppable inventory. POST /cells returns pending_provision and a phone order ($229 / $79). phone_number is empty until linked. Do not pass client_id. You cannot bring your own number or handset.

const cell = await agentcell.cells.create({
  displayName: "support-agent",
  areaCode: "415",
});
// phoneNumber is empty until the handset claims

List and health

List cells for the organization or a pod. GET a cell may include public phone (no ADB) and public order (tracking, 1–72h, 229/79). Health is online when phones.ws_connected.

GET /cells — fleet list with limit (10/25/50) and page_token
GET /cells/{cell_id} — single cell + public phone + order
GET /cells/{cell_id}/health — radio WebSocket / heartbeat
GET /cells/{cell_id}/ownership — phone, SIM, number bundle

Status	Meaning
pending_provision	Waiting for a handset to claim (typically 1–72h).
Active	Linked number; send if the radio is connected.
Suspended	Billing needs attention; 30-day reinstatement window.
Forfeited	The reinstatement window ended; number is gone.

Multi-cell fleets

One organization can own many cells. Group them into pods for campaigns, routing, and shared ignore/compliance policy. Additional cells charge another $150 setup + $50/mo on top of the $29 org monthly.

Ownership matters

Cells are yours while active. Learn about the 30-day suspension and $150 reinstatement policy.

Read the ownership policy

Common errors

PAYMENT_REQUIRED
Setup or hosting has not been paid.
CELL_NOT_READY
No E.164 yet; wait for the handset to claim.
VALIDATION_ERROR
Missing display_name. area_code is optional. client_id is not a cell field.

Copy for Cursor / Claude

Create a cell, wait for the handset, then send.

curl -X POST https://api.agentcell.store/v1/cells \
  -H "Authorization: Bearer $AGENTCELL_API_KEY" \
  -d '{"display_name":"support-agent","area_code":"415"}'

agentcell cells get --cell-id $CELL_ID
agentcell cells health --cell-id $CELL_ID