Send Message | AgentPhone

Send an outbound message (SMS or iMessage) via the provider assigned to the number.

Attach media by passing public HTTPS URLs in media_urls.

Single attachment

Pass a single-item array in media_urls. The URL must be publicly accessible.

Carousel / multi-image (iMessage)

To send a carousel of images on iMessage, pass 2-20 URLs in media_urls. Requirements:

Each URL must be a publicly accessible HTTPS link to an image (JPEG, PNG, GIF, etc.)
Minimum 2 URLs, maximum 20
body must be omitted or empty (text cannot be sent alongside a carousel)
Only supported on iMessage-capable lines

Deprecation notice: The media_url field (singular) is deprecated and will be removed in a future version. Use media_urls (array) instead — even for a single attachment, pass it as media_urls: ["https://..."].

Send an outbound message (SMS or iMessage) via the provider assigned to the number. Attach media by passing public HTTPS URLs in `media_urls`. ### Single attachment Pass a single-item array in `media_urls`. The URL must be publicly accessible. ### Carousel / multi-image (iMessage) To send a carousel of images on iMessage, pass 2-20 URLs in `media_urls`. Requirements: - Each URL must be a **publicly accessible HTTPS link** to an image (JPEG, PNG, GIF, etc.) - Minimum 2 URLs, maximum 20 - `body` must be omitted or empty (text cannot be sent alongside a carousel) - Only supported on iMessage-capable lines > **Deprecation notice:** The `media_url` field (singular) is deprecated and will be removed in a future version. Use `media_urls` (array) instead — even for a single attachment, pass it as `media_urls: ["https://..."]`.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

agent_idstringRequired

to_numberstringRequired

bodystringRequired

media_urlstring or nullOptional

media_urlslist of strings or nullOptional

number_idstring or nullOptional

Response

Successful Response

idstring

statusstring

channelstring

from_numberstring

to_numberstring

media_urlslist of stringsDefaults to []

Errors

422

Unprocessable Entity Error