Skip to main content
POST
Send a message

Authorizations

Authorization
string
header
required

Headers

Quo-Api-Version
enum<string>
required

API version header. Supported values: 2026-03-30

Available options:
2026-03-30

Body

application/json
content
string
required

The content of your message.

Required string length: 1 - 1600
Example:

"Good morning, your service appointment has been booked."

from
string
required

The ID of the Quo phone number to send from. The sender must be a user on this number.

Pattern: ^PN(.*)$
Example:

"PN123abc"

to
string[]
required

The recipients of the message, each a phone number in E.164 format or a short code (3-8 digits). More than one sends a group message. At most 10.

Required array length: 1 - 10 elements

A recipient phone number in E.164 format, or a short code (3-8 digits).

Pattern: ^\+[1-9]\d{1,14}$
Example:

"+15555555555"

Examples:
senderUserId
string | null

The unique identifier of the Quo user sending the message. If not provided, the message is attributed to the owner of the phone number it is sent from. The sending user must be a member of the phone number the message is sent from.

Pattern: ^US(.*)$
inboxStatus
string | null

Used to set the status of the related Quo inbox conversation. The default behavior without setting this parameter will be for the message sent to show up as an open conversation in the user's inbox. Setting the parameter to 'done' would move the conversation to the Done inbox view.

Allowed value: "done"
Example:

"done"

Response

Accepted

data
object
required