Place an outbound phone call | TelEcho API Reference

Place an outbound phone call from one of your imported phone numbers. The selected number must be active and have an outbound SIP trunk configured. The agent or workflow attached to the phone number is used unless you override it.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

phone_number_idstringRequired

Public phone-number ID to call from (must be active with an outbound trunk).

destination_numberstringRequired3-20 characters

E.164 destination number, e.g. ‘+14155021922’.

agent_idstringOptional

Override the phone number's assigned agent.

workflow_idstringOptional

Override the phone number's assigned workflow.

metadatamap from strings to anyOptional

Optional metadata stored with the call session.

Response

Successful Response

call_idstring

room_namestring

statusstring

phone_numberstring

destination_numberstring

Errors

422

Make Outbound Call Calls Outbound Post Request Unprocessable Entity Error

$	curl -X POST https://next-dev.rtcleague.com/api/v1/public/calls/outbound \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"phone_number_id": "tel_pn_b8e44d12",
>	"destination_number": "+14155021922",
>	"metadata": {
>	"customer_id": "cus_123"
>	}
>	}'

1	{
2	"call_id": "tel_call_19a8c4d3e2f1",
3	"room_name": "call-a3f9b22e1c4d",
4	"status": "initiated",
5	"phone_number": "+12345401155",
6	"destination_number": "+14155021922"
7	}