SIsinch
Callouts
Conferences

Callout Request

Changed on

Makes a call out to a phone number. The types of callouts currently supported are conference callouts, text-to-speech callouts, and custom callouts. The custom callout is the most flexible, but text-to-speech and conference callouts are more convenient.

post/calling/v1/callouts

Request

  • Base URL
    https://calling.api.sinch.com
  • URL
    https://calling.api.sinch.com/calling/v1/callouts
  • Auth
    • HTTP basic
    • or API key in header Authorization

Request body

OR
OR

Example request

{
  "conferenceCallout": {
    "cli": "14151112223333",
    "destination": {
      "type": "number",
      "endpoint": "+12125550123"
    },
    "locale": "en-US",
    "greeting": "Welcome to the conference",
    "domain": "pstn"
  }
}

Response

A success response, or an Error.

callIdstring

The returned call identifier.

Example response

{
  "callId": "adf92089-d9e8-4f14-a377-1e975f588fe4"
}

Changes

  • f5275c330844Revision changes
    • info

      added the new optional request property /////