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