Send Text Message

curl --request POST \
  --url https://api.blutext.com/v1/text-messages \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "to": "+14155550100",
  "message": "Hello from Blutext!",
  "check_dnc": true
}
'

{
  "message_id": "5b5f0f0e-9e3a-4c3a-9a1e-2f2d6e1c1234",
  "status": "queued",
  "to_phone_number": "+1 415-555-0100",
  "to_phone_normalized": "+14155550100",
  "recipient_country": "US",
  "recipient_timezone": "GMT-7",
  "recipient_location": "San Francisco, United States",
  "recipient_local_time": "3:15 PM, Tuesday, Aug 20",
  "timezone_offset": -7,
  "is_dst": true,
  "scheduled_send_date": "2025-08-20T22:15:00.000Z",
  "within_business_hours": true,
  "can_send_now": true,
  "manual_mode": false,
  "available_to_group": false,
  "check_dnc": true,
  "business_hours": "9:00 AM - 7:00 PM local time",
  "message_length": 19,
  "max_retries": 3,
  "message": "Message queued for immediate sending"
}

{
  "error": true,
  "message": "Validation failed",
  "statusCode": 400,
  "details": {
    "validationErrors": [
      "Invalid phone number format"
    ]
  },
  "timestamp": "2025-08-20T16:06:00.000Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

POST

text-messages

curl --request POST \
  --url https://api.blutext.com/v1/text-messages \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "to": "+14155550100",
  "message": "Hello from Blutext!",
  "check_dnc": true
}
'

{
  "message_id": "5b5f0f0e-9e3a-4c3a-9a1e-2f2d6e1c1234",
  "status": "queued",
  "to_phone_number": "+1 415-555-0100",
  "to_phone_normalized": "+14155550100",
  "recipient_country": "US",
  "recipient_timezone": "GMT-7",
  "recipient_location": "San Francisco, United States",
  "recipient_local_time": "3:15 PM, Tuesday, Aug 20",
  "timezone_offset": -7,
  "is_dst": true,
  "scheduled_send_date": "2025-08-20T22:15:00.000Z",
  "within_business_hours": true,
  "can_send_now": true,
  "manual_mode": false,
  "available_to_group": false,
  "check_dnc": true,
  "business_hours": "9:00 AM - 7:00 PM local time",
  "message_length": 19,
  "max_retries": 3,
  "message": "Message queued for immediate sending"
}

{
  "error": true,
  "message": "Validation failed",
  "statusCode": 400,
  "details": {
    "validationErrors": [
      "Invalid phone number format"
    ]
  },
  "timestamp": "2025-08-20T16:06:00.000Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

{
  "error": true,
  "message": "<string>",
  "statusCode": 123,
  "details": {},
  "timestamp": "2023-11-07T05:31:56Z"
}

Authorizations

X-Api-Key

string

header

required

Provide your Blutext API key. Authorization: Bearer is also supported.

Body

application/json

string

required

Recipient phone number in E.164 format (e.g., +14155550100)

message

string

required

Text message body

send_date

string<date-time>

Optional ISO 8601 datetime to schedule sending

manual_mode

boolean

default:false

Require manual approval before sending

available_to_group

boolean

default:false

Make message visible to the API key's group

check_dnc

boolean

default:false

Check Do Not Call list before queueing

Response

Message created successfully

message_id

string<uuid>

status

enum<string>

Available options:

queued,

scheduled

to_phone_number

string

to_phone_normalized

string

recipient_country

string

recipient_timezone

string

recipient_location

string

recipient_local_time

string

timezone_offset

is_dst

boolean

scheduled_send_date

string<date-time>

within_business_hours

boolean

can_send_now

boolean

manual_mode

boolean

available_to_group

boolean

check_dnc

boolean

business_hours

string

message_length

integer

max_retries

integer

message

string

Human-readable status message added by the API

Quickstart

API documentation

Endpoints

Authorizations

Body

Response