×
POST

https://{{base_url}}/v2/accounts/{{AccountSID}}/bridges

Parameter Name

Mandatory / Optional

Value

Description

leg_sids

Mandatory

Array of Strings:[""]

List of legSIDs of the active legs, that we want to be a part of the bridge.

bridge_event_endpoint

Mandatory

String

Endpoint to send events.

absorb_dtmf

Optional

Boolean

If true, DTMF tones from all legs on the bridge will be absorbed and not passed to others

{
    "leg_sids":["2tdAWSaOchu4VxFIQqf4IBm0EMH00000", "2tdAcyul4xmM2zXiK8nkYYmxrsg00000"],
    "absorb_dtmf": true,
    "bridge_event_endpoint": grpc://grpcEndpoint.com:port"
}

Response:

Parameter Name

Type

bridge_sid

string

created_at

string

account_sid

string

leg_sids

array[string] (optional)

bridge_event_endpoint

string

External Events:

Event Name

Event Type

Event Data

Data

“bridge_created”

bridge_lifecycle_event

None

bridge.state: active

“bridge_failed_to_create”

bridge_lifecycle_event

event_data:

error:

“error_code” : …,

“message”: “…”,

“description”: ”...”

bridge.state: terminal

“bridge_terminal”

bridge_lifecycle_event

None

bridge.state: terminal

“leg_joined_bridge”

leg_lifecycle_event

event_data: bridge_sid: "2QmZ1EgVpS25l4ujkjGjCEsnajY00000"

leg.state: connected

“leg_left_bridge”

leg_lifecycle_event

event_data: bridge_sid: "2QmZ1EgVpS25l4ujkjGjCEsnajY00000"

leg.state: connected

{
  "event_sid": "2QmZ1DghXqX1iU9PUrfexRHkECU00000",
  "event_type": "bridge_lifecycle_event",
  "event_name": "bridge_created",
  "event_timestamp": {
    "seconds": 1685960499,
    "nanos": 272434000
  },
  "data": {
    "account_sid": "exotel60",
    "date_created": "2023-06-05T10:21:39.079165726Z",
    "date_updated": "2023-06-05T10:21:39.15787587Z",
    "sid": "2QmZ1EgVpS25l4ujkjGjCEsnajY00000",
    "start_time": "2023-06-05T10:21:39.15787587Z",
    "state": "active"
  }
}
{
  "event_sid": "2QmZ1FhpEDIcs6YAhSQdXnbUxkf00000",
  "event_type": "leg_lifecycle_event",
  "event_name": "leg_joined_bridge",
  "event_timestamp": {
    "seconds": 1685960499,
    "nanos": 447549903
  },
  "event_data": {
    "data": {
      "bridge_sid": "2QmZ1EgVpS25l4ujkjGjCEsnajY00000"
    }
  },
  "data": {
    "account_sid": "exotel60",
    "caller_id": "8030752501",
    "contact_uri": "07417712343",
    "custom_param": "MD_LEGS",
    "date_created": "2023-06-05T10:21:20.058556349Z",
    "date_updated": "2023-06-05T10:21:39.407218765Z",
    "dc_code": "101",
    "direction": "outbound",
    "exophone": "08030752400",
    "leg_sid": "2QmYyp1kD1bbAKxWjNxAAnlGMn100000",
    "network_type": "pstn",
    "nso_code": "9988fd96-ce41-11ed-9a09-0242ac110003",
    "start_time": "2023-06-05T10:21:20.133846202Z",
    "state": "connected",
    "time_limit": 14400
  }
}