Skip to main content
POST
https://prod-contactswing-fastapi-962560522883.us-central1.run.app
/
v2
/
actions
Create Email Action
curl --request POST \
  --url https://prod-contactswing-fastapi-962560522883.us-central1.run.app/v2/actions \
  --header 'Authorization: <authorization>'
{
  "ctx_id": "<string>",
  "data": {
    "action_id": "<string>",
    "name": "<string>",
    "type": "<string>"
  }
}

​
Authorizations

​
Authorization
string
required
Enter your ContactSwing JWT Bearer token.

​
Request Body

​
name
string
required
Action display name. Example: My Email Action
​
description
string
required
Action purpose. Example: Send email when user requests communication
​
action_timing
string
required
When to trigger: "DURING"
​
type
string
required
Action type: "SEND_EMAIL"
​
webhook
object
Webhook configuration
​
email
object
required
Email configuration object

​
Email Configuration

​
email.to
object
Recipient email addresses
​
value
array
["[email protected]"]
​
email.from
string
Sender email. Example: "[email protected]"
​
email.from_type
string
Email provider: "gmail"
​
email.user_id
string
User ID for authentication
​
email.cc
string
CC recipients (comma-separated)
​
email.bcc
string
BCC recipients (comma-separated)
​
email.subject
object
Email subject line
​
value
string
"Welcome to Contactswing"
​
email.body
object
Email content (HTML supported)
​
value
string
"<p>Hello</p>"
​
email.attachment
object
File attachments {}
​
email.send_static_contect
boolean
Send static content flag
​
email.response_message_context
string
Response message context

​
Response

201 Created - Email action created successfully
​
ctx_id
string
Request context ID
​
data
object
​
action_id
string
New email action ID
​
name
string
Action name
​
type
string
”SEND_EMAIL”
400 Bad Request - Invalid email configuration 401 Unauthorized - Invalid token