Skip to main content
POST
Choose the Call Control App
Every call from this account’s numbers goes through one Call Control App in your Telnyx account. Let Yappr create it, or give one you made. Requires carrier_accounts:manage. Let Yappr create it on an outbound voice profile of yours. Yappr creates an app named “Yappr outbound” with its webhook URL set, and never creates or changes an outbound voice profile: its countries and spend limits stay your decision.
Or use an app you made just for Yappr. Its webhook URL must be exactly the account’s webhook_url (returned when you connected, or by get with a carrier_accounts:manage key), it must have an outbound voice profile, and it must be switched on.
The response is the carrier account with connection set. Next: add your numbers.

Errors

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Path Parameters

id
string<uuid>
required

Body

application/json

Send exactly one of create or connection_id.

create
object

Yappr creates a Call Control App named "Yappr outbound" in your account, on this outbound voice profile.

connection_id
string

A Call Control App you made just for Yappr. Its webhook URL must be exactly this account's webhook_url, it must have an outbound voice profile, and it must be switched on.

Response

App connected

data
object

Your own Telnyx account, connected so agents can call from the numbers you own there. Yappr places each call on your Call Control App, with your API key, so the call runs on your Telnyx account and Telnyx bills you for it. The API key is write-only: no response ever contains it.