Skip to main content
POST
https://prod-contactswing-fastapi-962560522883.us-central1.run.app
/
v2
/
actions
Create Action
curl --request POST \
  --url https://prod-contactswing-fastapi-962560522883.us-central1.run.app/v2/actions \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "type": "<string>",
  "round_robin_emails": [
    {}
  ]
}
'
{
  "ctx_id": "<string>",
  "data": {},
  "message": "<string>"
}

​
Authorizations

​
Authorization
string
required
Enter your ContactSwing JWT Bearer token.

​
Request Body Parameters

​
name
string
required
Action display name. Example: My SMS Action
​
description
string
required
Action description for when to trigger it.
​
type
string
required
Action Type (select one):
  • SEND_SMS - SMS via Twilio
  • SEND_EMAIL - Email automation
  • WEBHOOK - Custom API calls
  • APPOINTMENT - Calendar booking
  • CALL_TRANSFER - Phone transfers
  • SEND_WHATSAPP - WhatsApp messages
  • DTMF_ACTION - Phone menu navigation
  • SINGLEDATAEXTRACTION - Data extraction
​
round_robin_emails
array
required
[]

​
Response

201 Created - Action created successfully
​
ctx_id
string
Request context ID
​
data
object
Newly created action details matching Get Action by ID format.
​
message
string
"Request processed successfully"