Log inTry for free
Back to all APIs

Create outbound call conversation

Use this method to create a conversation associated with an outbound call. Expected usage is to trigger this endpoint and then start a call using the RTC SDK callConversations method. The created conversation ID is required when using the callConversations method to trigger an outbound call. Another option is to use the ID of a previously created call conversation. More info.

Please log in to see full path URL. Learn why.
post
/ccaas/voice/2/outbound-call-conversation
Authorizations:
API Key Header
Basic
IBSSO Token Header
OAuth 2
Scopes:
conversations:manage
Request Body schema:
application/json
collapse all -
from
required
string

DID number that is used to originate the call. DID numbers can be configured through the portal, or using the 'Purchase a number' endpoint.

to
required
string

Destination number.

agentId
required
string

Id of the agent originating the call.

voiceClientType
string
Default: "PSTN"
Enum: "PSTN" "WEBRTC" "WHATSAPP" "VIBER"

Voice client type of the destination number.

Responses

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

500

Internal Server Error

Request samples

Content type
application/json
Copy
 Collapse all
{
  • "from": "385998779621",
  • "to": "38761123123",
  • "agentId": "2010EA93ABC142E812C19F529BCBD22F",
  • "voiceClientType": "PSTN"
}

Response samples

Content type
application/json

Successful response

Copy
 Collapse all
{
  • "from": "385998779621",
  • "to": "38761123333",
  • "conversationId": "718A037A2FE0D2D5AA2D12A7240ED8C4",
  • "agentId": "2010EA93ABC142E812C19F529BCBD22F"
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products
Learn more
Service status

Copyright @ 2006-2025 Infobip ltd.

Privacy documentsTerms of use