Skip to main content
POST
/
v1
/
messages
Send a text message
curl --request POST \
  --url https://api.openphone.com/v1/messages \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "<string>",
  "from": "<string>",
  "to": [
    "<string>"
  ],
  "phoneNumberId": "<string>",
  "userId": "<string>",
  "setInboxStatus": "done"
}
'
{
  "data": {
    "id": "<string>",
    "to": [
      "<string>"
    ],
    "from": "<string>",
    "text": "<string>",
    "phoneNumberId": "PN123abc",
    "direction": "incoming",
    "userId": "<string>",
    "status": "queued",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

Body

application/json
​
content
string
required

The text content of the message to be sent.

Required string length: 1 - 1600
​
from
required
​
to
string[]
required
Required array length: 1 element

A phone number in E.164 format, including the country code.

​
phoneNumberId
string
deprecated

DEPRECATED, use "from" instead. OpenPhone phone number ID to send a message from

Example:

"OP1232abc"

​
userId
string

The unique identifier of the OpenPhone user sending the message. If not provided, defaults to the phone number owner.

Example:

"US123abc"

​
setInboxStatus
enum<string>

Used to set the status of the related OpenPhone 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.

Available options:
done
Example:

"done"

Response

Success

​
data
object
required