Skip to main content
POST
/
api
/
telephony
/
calls
/
initiate
Initiate outbound call
curl --request POST \
  --url https://api.g-tateth.com/api/telephony/calls/initiate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customerPhone": "+2348012345678",
  "agentId": "<string>",
  "customerId": "<string>",
  "conversationId": "<string>",
  "customGreeting": "<string>",
  "recordingEnabled": true
}
'
{
  "success": true,
  "data": {
    "callId": "<string>",
    "conversationId": "<string>",
    "status": "initiated",
    "webRTC": {}
  }
}

Authorizations

Authorization
string
header
required

JWT token authentication (for user sessions)

Body

application/json
customerPhone
string
required

Customer phone number in E.164 format

Example:

"+2348012345678"

agentId
string
required

ID of the agent making the call

customerId
string

Existing customer ID (optional)

conversationId
string

Link call to existing conversation

customGreeting
string

Custom greeting message to play before connecting

recordingEnabled
boolean
default:true

Enable call recording

Response

200 - application/json

Call initiated successfully

success
boolean
data
object