Skip to main content
POST
/
v2
/
_actions
Create Real Time Booking 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>",
  "action_timing": "<string>",
  "type": "<string>",
  "webhook": {
    "email": "<string>",
    "type": "<string>",
    "user_id": "<string>",
    "mandatory": true,
    "timezone": "<string>",
    "buffer_time": 123,
    "booking_timings": {
      "monday": {}
    },
    "round_robin_emails": [
      "<string>"
    ]
  }
}
'
{
  "ctx_id": "<string>",
  "data": {
    "action_id": "<string>",
    "name": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.contactswing.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Authorizations

​
Authorization
string
required
Enter your Bearer token.

​
Request Body

​
name
string
required
Action display name.
​
description
string
required
Action purpose.
​
action_timing
string
required
"DURING" | "AFTER" | "BEFORE"
​
type
string
required
Action type: "APPOINTMENT"
​
webhook
object
required
Booking configuration.
​
email
string
required
Google Calendar email.
​
type
string
required
"google" or "outlook"
​
user_id
string
required
The UUID of the user.
​
mandatory
boolean
Require confirmation.
​
timezone
string
IANA timezone.
​
buffer_time
integer
Minutes between bookings.
​
booking_timings
object
Weekly availability.
​
monday
object
Monday schedule (e.g. {"start_time": "09:00", "end_time": "17:00"})
​
round_robin_emails
string[]
List of email addresses for distribution. Leave as [] for none.

​
Response

201 Created - Action created successfully
​
ctx_id
string
Request context ID
​
data
object
​
action_id
string
New action ID
​
name
string
Action name