Skip to main content

Attach connections to an outbound profile



Attaches the specified connections to an outbound profile if they are not already attached. Note that this endpoint never removes connections already attached.


Path Parameters

    id stringrequired

    ID of outbound profile to update



IDs of connections to attach to the outbound profile

    connection_ids string[]required


200: Outbound Profile updated response


    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

    Default value: false

    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

    Default value: false

    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