Skip to main content

Create an outbound voice profile

POST 
/outbound_voice_profiles

Create an outbound voice profile.

Request​

Body

required

Parameters that can be defined when creating an outbound voice profile

    name stringrequired

    Possible values: >= 3 characters

    A user-supplied name to help with organization.

    traffic_type TrafficType (string)

    Possible values: [conversational, short_duration]

    Default value: conversational

    Specifies the type of traffic allowed in this profile.

    service_plan ServicePlan (string)

    Possible values: [us, international, global]

    Default value: global

    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 Voice Profiles.

    concurrent_call_limit integernullable

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

    enabled boolean

    Default value: true

    Specifies whether the outbound voice profile can be used. Disabled profiles will result in outbound calls being blocked for the associated Connections.

    tags string[]
    usage_payment_method UsagePaymentMethod (string)

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    Setting for how costs for outbound profile are calculated.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound voice profile formatted in alpha2.

    max_destination_rate number

    Maximum rate (price per minute) for a Destination to be allowed when making outbound calls.

    daily_spend_limit string

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

    daily_spend_limit_enabled boolean

    Specifies whether to enforce the daily_spend_limit on this outbound voice profile.

    call_recording

    object

    call_recording_type string

    Possible values: [all, none, by_caller_phone_number]

    Specifies which calls are recorded.

    call_recording_caller_phone_numbers string[]

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

    call_recording_channels string

    Possible values: [single, dual]

    Default value: single

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

    call_recording_format string

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    billing_group_id uuidnullable

    The ID of the billing group associated with the outbound proflile. Defaults to null (for no group assigned).

Responses​

200: Successful response

Schema

    data

    object

    id int64

    Identifies the resource.

    record_type string

    Identifies the type of the resource.

    name stringrequired

    Possible values: >= 3 characters

    A user-supplied name to help with organization.

    connections_count integer

    Amount of connections associated with this outbound voice profile.

    traffic_type TrafficType (string)

    Possible values: [conversational, short_duration]

    Default value: conversational

    Specifies the type of traffic allowed in this profile.

    service_plan ServicePlan (string)

    Possible values: [us, international, global]

    Default value: global

    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 Voice Profiles.

    concurrent_call_limit integernullable

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

    enabled boolean

    Default value: true

    Specifies whether the outbound voice profile can be used. Disabled profiles will result in outbound calls being blocked for the associated Connections.

    tags string[]
    usage_payment_method UsagePaymentMethod (string)

    Possible values: [tariff, rate-deck]

    Default value: rate-deck

    Setting for how costs for outbound profile are calculated.

    whitelisted_destinations string[]

    Default value: US,CA

    The list of destinations you want to be able to call using this outbound voice profile formatted in alpha2.

    max_destination_rate number

    Maximum rate (price per minute) for a Destination to be allowed when making outbound calls.

    daily_spend_limit string

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

    daily_spend_limit_enabled boolean

    Specifies whether to enforce the daily_spend_limit on this outbound voice profile.

    call_recording

    object

    call_recording_type string

    Possible values: [all, none, by_caller_phone_number]

    Specifies which calls are recorded.

    call_recording_caller_phone_numbers string[]

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

    call_recording_channels string

    Possible values: [single, dual]

    Default value: single

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

    call_recording_format string

    Possible values: [wav, mp3]

    Default value: wav

    The audio file format for calls being recorded.

    billing_group_id uuidnullable

    The ID of the billing group associated with the outbound proflile. Defaults to null (for no group assigned).

    created_at string

    ISO 8601 formatted date-time indicating when the resource was created.

    updated_at string

    ISO 8601 formatted date-time indicating when the resource was updated.

401: Unauthorized

404: Resource not found

422: Bad request

Loading...