Send a message

Send a text message from your Quo number to one or more recipients.

POST /messages

Send a message

cURL

curl --request POST \
  --url https://dev-public-api.openphone.dev/messages \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'Quo-Api-Version: <quo-api-version>' \
  --data '
{
  "content": "Good morning, your service appointment has been booked.",
  "from": "PN123abc",
  "to": [
    "[phone]"
  ],
  "senderUserId": "<string>",
  "inboxStatus": "done"
}
'

202

Example

{
  "data": {
    "id": "AC123abc",
    "to": [
      "[phone]"
    ],
    "from": "[phone]",
    "text": "Hello, world!",
    "conversationId": "CN123abc",
    "direction": "incoming",
    "status": "sent",
    "createdAt": "2022-01-01T00:00:00Z",
    "updatedAt": "2022-01-01T00:00:00Z",
    "media": [
      {
        "url": "https://example.com/image.png",
        "type": "image/png"
      }
    ],
    "phoneNumberId": "PN123abc",
    "userId": "US123abc"
  }
}

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:

"[phone]"

Examples:

["[phone]"]

["[phone]", "[phone]"]

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

202

application/json

Accepted

data · object · required

Show child attributes