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.
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.
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`.
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.