Skip to main content
POST
/
messages
/
sms
Send an SMS message
curl --request POST \
  --url https://api.pokulabs.com/messages/sms \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "message": "<string>",
  "to": "<string>",
  "from": "<string>",
  "waitTime": 60,
  "followUpTime": 6000
}
'
{
  "interactionId": "092f9eb4-3694-4718-9084-5c786afa87ec"
}

Authorizations

​
Authorization
string
header
required

Authentication header containing your Poku API key. Find it in the Poku dashboard. The format is "Bearer YOUR_API_KEY"

Body

application/json
​
message
string
required

The content of the message.

​
to
string
required

The number you want to message, in E.164 format. See supported countries for Poku numbers here.

​
from
string

Defaults to your Poku reserved number. If you don't have one, falls back to a Poku shared number.

You can also bring your own number from Twilio or Messagebird. Configure your credentials on the Integrations page and pass the number here in E.164 format. If it's a US number, it must be approved for A2P texting.

​
waitTime
number

When undefined or not supplied, no reply is captured.

When supplied, this is the number of seconds the API request is held open waiting for a reply. Poku returns the reply in the HTTP response.

Required range: 1 <= x <= 600
Example:

60

​
followUpTime
number

Duration in seconds to keep listening for a reply after the waitTime window closes.

When a reply arrives within this window, Poku sends it to any webhooks you've configured.

Required range: 1 <= x <= 60000
Example:

6000

Response

200 - application/json

Message sent successfully.

​
interactionId
string

Returned when no waitTime is set. Unique identifier for this interaction.

​
response
string

Returned when waitTime is set. Contains the recipient reply, or a timeout message if no reply was received.