Phone numbers

Use this endpoint before POST /api/v1/chats. Pass one returned phone_number as the from value. Use phone_line_id when an endpoint lets you pin a send to a specific sender line.

Request

curl https://console.trychert.com/api/v1/phone-numbers \
  -H "Authorization: Bearer $CHERT_SIGNING_SECRET"

Response

{
  "phone_numbers": [
    {
      "id": "pl_01H...",
      "phone_line_id": "pl_01H...",
      "phone_number": "+15555550100",
      "service": "imessage",
      "is_active": true,
      "capabilities": ["imessage", "send", "receive"]
    }
  ]
}

Fields

Field	Meaning
`id`	Stable Chert phone-line id. Same value as `phone_line_id`.
`phone_line_id`	Use this with request fields named `phone_line_id`.
`phone_number`	E.164 sender number. Use this as `from` in Chats.
`service`	Currently `imessage` for Chert-managed sends.
`is_active`	Whether the number can currently participate in messaging.
`capabilities`	`send`, `receive`, `imessage`, and future service flags.

Chert pins a sender line after the first successful conversation with a recipient. Follow-ups reuse that line automatically. For native voice notes, choose an active line whose capabilities includes send and that Chert has enabled for voice notes. Stage with its phone_line_id, then copy the exact phone_line_id returned by staging into /send. Staged voice-note IDs cannot move between lines.

Get started

Messages

Chats

Group chats

Contact sharing

Webhooks and events

Reference

Phone numbers

Request

Response

Fields

See also

​Request

​Response

​Fields

​See also

Request

Response

Fields

See also