curl --request POST \
--url https://api.salescaptain.com/v1/send-sms/{company_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"to_phone": "+14155551234",
"conversation_profile_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"message_body": "Hi John, your technician is on the way and should arrive in 20 minutes.",
"contact_name": "John Smith"
}
'
{
"message": "SMS sent successfully!",
"data": {
"contact_id": "e5f6a7b8-c9d0-1234-ef12-345678901234",
"conversation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"conversation_profile_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"from_number": "+14155559876",
"to_number": "+14155551234",
"message": {
"conversation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"author": "Jane Doe",
"body": "Hi John, your technician is on the way and should arrive in 20 minutes.",
"date_created": "2026-11-19T10:30:00.000Z",
"is_me": true,
"message_type": "sms_message",
"sent_by_id": "d4e5f6a7-b8c9-0123-def1-234567890123",
"sent_by_username": "Jane Doe",
"message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
}
Messages
Send SMS
Sends an SMS directly to a phone number from the conversation profile (one of your numbers) you choose.
- If no contact exists for
to_phone, a contact is created. - If the contact has no conversation on the chosen conversation profile yet, one is created.
- The message is then sent from that profile’s number.
Messages can be free-form text written at send time; no pre-approved template is required.
template_id is optional and only fills in a saved SMS template (see /v1/sms/list-templates/{company_id}).
Sending requires the company’s A2P (10DLC) registration to be complete and is subject to the
company’s hourly and per-minute messaging limits.
account_id is resolved from the authenticated user’s account that matches company_id.
POST
/
v1
/
send-sms
/
{company_id}
curl --request POST \
--url https://api.salescaptain.com/v1/send-sms/{company_id} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"to_phone": "+14155551234",
"conversation_profile_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"message_body": "Hi John, your technician is on the way and should arrive in 20 minutes.",
"contact_name": "John Smith"
}
'
{
"message": "SMS sent successfully!",
"data": {
"contact_id": "e5f6a7b8-c9d0-1234-ef12-345678901234",
"conversation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"conversation_profile_id": "c3d4e5f6-a7b8-9012-cdef-123456789012",
"from_number": "+14155559876",
"to_number": "+14155551234",
"message": {
"conversation_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"author": "Jane Doe",
"body": "Hi John, your technician is on the way and should arrive in 20 minutes.",
"date_created": "2026-11-19T10:30:00.000Z",
"is_me": true,
"message_type": "sms_message",
"sent_by_id": "d4e5f6a7-b8c9-0123-def1-234567890123",
"sent_by_username": "Jane Doe",
"message_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
}
}
Authorizations
Path Parameters
Body
application/json

