imessage-lines
Manage the iMessage sender lines required before you can send over iMessage. See SMS vs. iMessage for setup steps.
List iMessage lines
Returns every iMessage line (dedicated sender + phone number) available to the organization, including its activation status, contact identity shown to leads, and workspace visibility.
Order a new iMessage line
Orders a new dedicated iMessage line (a phone number your team can send/receive blue-bubble iMessages from) for the organization. Billing plan and add-ons are fixed on our end; only the region, area code, and the identity shown to leads are configurable. The line starts in 'pending' status until activation completes.
Attach an already-provisioned iMessage line
Attaches an iMessage line you already provisioned directly with us (used for an organization's first-ever line, which must be set up before it can be ordered through this API) instead of ordering a new one. Bills the organization the same as `create`.
Update an iMessage line
Updates an iMessage line's identity, workspace visibility, or status (e.g. to disable it).
Cancel an iMessage line
Permanently cancels an iMessage line. This is not reversible; existing conversation history is kept.
Upload an iMessage line contact photo
Uploads a contact photo for an iMessage line. Must be a PNG or JPG file with a 1:1 (square) aspect ratio; multipart/form-data with the file under the 'photo' field. Returns a public URL to pass as `contactPhotoUrl` on create/import/update.