Skip to main content
POST
Create Call Transfer Action

Authorizations

Authorization
string
required
Enter your ContactSwing JWT Bearer token.

Request Body

name
string
required
Action display name. Example: My Call Transfer Action
description
string
required
Action purpose. Example: Transfer to human when user requests agent or is unhappy
action_timing
string
required
When to trigger: "DURING"
type
string
required
Action type: "CALL_TRANSFER"
phone_number
string
required
Destination phone number. Example: "12817126508"
webhook
object
Webhook configuration
extension_enabled
boolean
Enable extension support. Example: false
speech
string
Custom speech prompt before transfer
runBeforeCall
boolean
Execute actions before transfer

Webhook Configuration

webhook.extension_enabled
boolean
Enable extension dialing

Response

201 Created - Call transfer action created successfully
ctx_id
string
Request context ID
data
object
action_id
string
New transfer action ID
name
string
Action name
type
string
”CALL_TRANSFER”
400 Bad Request - Invalid phone number or missing fields 401 Unauthorized - Invalid token