Skip to main content
POST
Create SMS Action

Authorizations

string
required
Enter your ContactSwing JWT Bearer token.

Request Body

string
required
Action display name. Example: My SMS Action
string
required
Action purpose. Example: Trigger SMS when user requests messaging
string
required
When to trigger: "DURING"
object
Webhook configuration
boolean
Require confirmation.
string
required
Action type: "SEND_SMS"
object
required
SMS configuration object
object
Recipient phone numbers
string[]
required
string
SMS provider: "TWILIO"
string
Sender phone number. Example: "+13465507166"
string[]
CC recipients []
object
SMS message content
string
Message template
string
string
Response message context. Example: I’ve just sent you a text message. Please let me know if you received it.

SMS Configuration

Response

201 Created - SMS action created successfully
string
Request context ID
object
string
New SMS action ID
string
Action name
string
”SEND_SMS”
400 Bad Request - Invalid SMS configuration or missing fields 401 Unauthorized - Invalid token