Skip to main content

Create an outbound profile

POST 
/termination/endpoints

Creates a new outbound profile object.

Request​

Body

required

Outbound Profile to add

    connection_ids string[]required
    name string

    A user-supplied name to help with organization

    traffic_type integerrequired

    Possible values: [1, 2]

    Default value: 1

    Conversational = 1, Short Duration = 2

    service_plan integerrequired

    Possible values: [1, 2, 4]

    Default value: 4

    Indicates the coverage of the termination regions. International and Global are the same but International may only be used for high volume/short duration outbound profiles. 3 (EEA originated) has been retired and is now covered by Global. Possible values are: US = 1, International = 2, Global = 4

    active boolean

    Defaults to true

    translation_rule string

    Only configure if advised by Telnyx support

    cps_limit_increase integer
    ports integer

    Must be no more than your concurrent call limit. Null means no limit.

    tag_list string[]
    usage_payment_method string

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    Setting for how costs for outbound profile are calculated.

    whitelisted_destination_format string

    Possible values: [alpha2, alpha3, iso_numeric]

    Format of your whitelisted destinations.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound profile.

    max_destination_rate float

    Maximum rate at which you can make a call using this outbound profile

    call_recording_type string

    Possible values: [all, none, by_call_phone_number]

    Defines how to filter which calls are recorded.

    call_recording_phone_numbers string[]

    When call_recording_type is set to by_caller_phone_number, only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.

    call_recording_format string

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    call_recording_channels string

    Possible values: [single, dual]

    Default value: single

    When using 'dual' channels, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    daily_spend_limit string

    The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound profile in a day before disallowing new calls. Example: 100.00.

    daily_spend_limit_enabled boolean

    Specifies whether to enforce the daily_spend_limit on this outbound profile.

    billing_group_id string

    The ID of the billing group to which the outbound profile is assigned. Defaults to null (for no group assigned).

Responses​

200: Outbound Profile created response

Schema

    id stringrequired
    user_id stringrequired
    connections object[]required
    name stringrequired

    A user-supplied name to help with organization

    traffic_type integerrequired

    Possible values: [1, 2]

    Default value: 1

    Conversational = 1, Short Duration = 2

    service_plan integerrequired

    Possible values: [1, 2, 4]

    Default value: 4

    Indicates the coverage of the termination regions. International and Global are the same but International may only be used for high volume/short duration outbound profiles. 3 (EEA originated) has been retired and is now covered by Global. Possible values are: US = 1, International = 2, Global = 4

    cps_limit integerrequired

    Default value: 100

    ports integerrequired

    Must be no more than your concurrent call limit. Null means no limit.

    translation_rule stringrequired
    active booleanrequired

    Default value: true

    Defaults to true

    cps_limit_increase integerrequired
    tag_list string[]required
    usage_payment_method string

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    custom_rate_deck booleanrequired
    rate_deck_url stringrequired

    url to rate deck

    whitelisted_destination_format string

    Possible values: [alpha2, alpha3, iso_numeric]

    Default value: alpha3

    Format of your whitelisted destinations.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound profile.

    max_destination_rate float

    Maximum rate at which you can make a call using this outbound profile

    connection_id string

    To be deprecated, maintained for backward compatibility

    call_recording_type stringrequired

    Possible values: [all, none, by_call_phone_number]

    Defines how to filter which calls are recorded.

    call_recording_phone_numbers string[]required

    When call_recording_type is set to by_caller_phone_number, only outbound calls using one of these numbers will be recorded. Numbers must be specified in E164 format.

    call_recording_format stringrequired

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    call_recording_channels stringrequired

    Possible values: [single, dual]

    Default value: single

    When using 'dual' channels, final audio file will be stereo recorded with the first leg on channel A, and the rest on channel B.

    daily_spend_limit stringrequired

    The maximum amount of usage charges, in USD, you want Telnyx to allow on this outbound profile in a day before disallowing new calls. Example: 100.00.

    daily_spend_limit_enabled booleanrequired

    Specifies whether to enforce the daily_spend_limit on this outbound profile.

    billing_group_id stringrequired

    The ID of the billing group to which the outbound profile is assigned. Defaults to null (for no group assigned).

400: Bad request

401: Unauthorized

Loading...