Send an SMS to a contact

POST

/users/me/contacts/{id}/send-sms

Sends an SMS from the user's SkipCalls-owned phone number to this contact. Body can be a literal text or an AI-drafted message (mode: 'ai' with a prompt). The outbound SMS is persisted and added to the contact's timeline automatically. Requires the user to own at least one active SMS-capable phone number; contact must have a valid phone.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢201

This response does not have a body.

Request Example

Shell

JavaScript

Java

Swift

curl --location '/users/me/contacts//send-sms' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "message": "string",
    "agentId": "string"
}'

Modified at 2026-07-23 18:02:16

Schedule an outbound call to a contact

UserProfileSubscriptionDto