Sign in
Profiles

Update a messaging profile

Updates the supplied settings on the specified messaging profile. Settings omitted from the request remain unchanged.

patch/messaging_profiles/{id}

Path parameters

idstring uuid required

The id of the messaging profile to retrieve

Request body

record_type'messaging_profile'

Identifies the type of the resource.

idstring uuid

Identifies the type of resource.

namestring

A user friendly name for the messaging profile.

enabledboolean

Specifies whether the messaging profile is enabled or not.

webhook_urlstring url nullable

The URL where webhooks related to this messaging profile will be sent.

webhook_failover_urlstring url nullable

The failover URL where webhooks related to this messaging profile will be sent if sending to the primary URL fails.

webhook_api_version'1' | '2' | '2010-04-01'

Determines which webhook format will be used, Telnyx API v1, v2, or a legacy 2010-04-01 format.

whitelisted_destinationsstring[]

Destinations to which the messaging profile is allowed to send. The elements in the list must be valid ISO 3166-1 alpha-2 country codes. If set to ["*"], all destinations will be allowed.

This field is required if the messaging profile doesn't have it defined yet.

created_atstring date-time

ISO 8601 formatted date indicating when the resource was created.

updated_atstring date-time

ISO 8601 formatted date indicating when the resource was updated.

v1_secretstring

Secret used to authenticate with v1 endpoints.

alpha_senderstring nullable

The alphanumeric sender ID to use when sending to destinations that require an alphanumeric sender ID.

daily_spend_limitstring

The maximum amount of money (in USD) that can be spent by this profile before midnight UTC.

daily_spend_limit_enabledboolean

Whether to enforce the value configured by daily_spend_limit.

mms_fall_back_to_smsboolean

enables SMS fallback for MMS messages.

mms_transcodingboolean

enables automated resizing of MMS media.

mobile_onlyboolean

Send messages only to mobile phone numbers.

smart_encodingboolean

Enables automatic character encoding optimization for SMS messages. When enabled, the system automatically selects the most efficient encoding (GSM-7 or UCS-2) based on message content to maximize character limits and minimize costs.

ai_assistant_idstring nullable

The ID of the AI assistant associated with this messaging profile.

redaction_enabledboolean

Set to true to enable message content redaction on this profile, or false to disable it. Ignored if the organization is not on the redaction allowlist. See the Message Redaction guide for what is redacted.

redaction_levelinteger

The redaction level to apply when redaction is enabled. 1: redact message records and reporting only. 2 (default): also redact inbound webhook payloads. See the Message Redaction guide.

Example request

{
  "name": "Updated Profile for Messages",
  "webhook_url": "https://www.example.com/hooks",
  "webhook_failover_url": "https://backup.example.com/hooks",
  "enabled": true,
  "webhook_api_version": "2",
  "whitelisted_destinations": [
    "US"
  ],
  "number_pool_settings": {
    "toll_free_weight": 10,
    "long_code_weight": 2,
    "skip_unhealthy": false,
    "sticky_sender": true,
    "geomatch": false
  },
  "url_shortener_settings": {
    "domain": "example.ex",
    "prefix": "cmpny",
    "replace_blacklist_only": true,
    "send_webhooks": false
  },
  "v1_secret": "rP1VamejkU2v0qIUxntqLW2c"
}

Response

Successful response with details about a messaging profile.

Example response

{
  "data": {
    "record_type": "messaging_profile",
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "Profile for Messages",
    "webhook_url": "https://www.example.com/hooks",
    "webhook_failover_url": "https://backup.example.com/hooks",
    "enabled": true,
    "webhook_api_version": "2",
    "whitelisted_destinations": [
      "US"
    ],
    "created_at": "2019-01-23T18:10:02.574Z",
    "updated_at": "2019-01-23T18:10:02.574Z",
    "number_pool_settings": {
      "toll_free_weight": 10,
      "long_code_weight": 2,
      "skip_unhealthy": false,
      "sticky_sender": true,
      "geomatch": false
    },
    "url_shortener_settings": {
      "domain": "example.ex",
      "prefix": "cmpny",
      "replace_blacklist_only": true,
      "send_webhooks": false
    },
    "v1_secret": "rP1VamejkU2v0qIUxntqLW2c",
    "health_webhook_url": null,
    "mms_fall_back_to_sms": false,
    "mms_transcoding": false,
    "daily_spend_limit": "100.00",
    "daily_spend_limit_enabled": false,
    "redaction_enabled": false,
    "redaction_level": 2,
    "mobile_only": false,
    "features": {
      "ai_opt_out_detection_enabled": true
    }
  }
}

Changes