---
title: "Update a sender's information, including `profile`, `webhook`, and `configuration`."
method: POST
path: "/v2/Channels/Senders/{Sid}"
tags: ["MessagingV2ChannelsSender"]
---

# Update a sender's information, including \`profile\`, \`webhook\`, and \`configuration\`.

`POST /v2/Channels/Senders/{Sid}`

(WhatsApp only) Update a Sender. You can update a sender's information, including `profile`, `webhook`, and `configuration`. To verify a phone number, set `configuration.verification_code` to the One-time Password (OTP) that you received.

## Path parameters

- `Sid` string, required

## Request body

- MessagingV2ChannelsSenderRequestsUpdate
  - `friendly_name` string, nullable — Optional display label for the sender in the Twilio Console.
  - `configuration` MessagingV2ChannelsSenderConfiguration, nullable — The configuration settings for creating a sender.
    - `waba_id` string, nullable — The ID of the WhatsApp Business Account (WABA) to use for this sender.
    - `verification_method` 'sms' | 'voice', nullable — The verification method.
    - `verification_code` string, nullable — The verification code.
    - `voice_application_sid` string, nullable — The SID of the Twilio Voice application.
    - `account_type` 'ISV' | 'ISVSubAccount', nullable — The account type for ISV Account Type Migration. Set to 'ISV' or 'ISVSubAccount' to configure, empty string to clear, or omit to preserve the existing value.
  - `webhook` MessagingV2ChannelsSenderWebhook, nullable — The configuration settings for webhooks.
    - `callback_url` string, nullable — The URL to send the webhook to.
    - `callback_method` 'POST' | 'PUT', nullable — The HTTP method for the webhook.
    - `fallback_url` string, nullable — The URL to send the fallback webhook to.
    - `fallback_method` 'POST' | 'PUT', nullable — The HTTP method for the fallback webhook.
    - `status_callback_url` string, nullable — The URL to send the status callback to.
    - `status_callback_method` string, nullable — The HTTP method for the status callback.
  - `profile` MessagingV2ChannelsSenderProfile, nullable — The profile information for the sender.
    - `name` string, nullable — The name of the sender. Required for WhatsApp senders and must follow [Meta's display name guidelines](https://www.facebook.com/business/help/757569725593362).
    - `about` string, nullable — The profile about text for the sender.
    - `address` string, nullable — The address of the sender.
    - `description` string, nullable — The description of the sender.
    - `logo_url` string, nullable — The logo URL of the sender.
    - `banner_url` string, nullable — The banner URL of the sender.
    - `privacy_url` string, nullable — The privacy URL of the sender. Must be a publicly accessible HTTP or HTTPS URI associated with the sender.
    - `terms_of_service_url` string, nullable — The terms of service URL of the sender.
    - `accent_color` string, nullable — The color theme of the sender. Must be in hex format and have at least a 4:5:1 contrast ratio against white.
    - `use_case` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP' | 'MULTI_USE', nullable — The messaging use case type for the RCS sender. Allowed values are `PROMOTIONAL`, `TRANSACTIONAL`, `OTP`, `MULTI_USE`. Defaults to `MULTI_USE` if not provided. Cannot be modified after launch.
    - `vertical` string, nullable — The vertical of the sender. Allowed values are: - `Alcohol` - `Automotive` - `Beauty, Spa and Salon` - `Clothing and Apparel` - `Education` - `Entertainment` - `Event Planning and Service` - `Finance and Banking` - `Food and Grocery` - `Hotel and Lodging` - `Matrimony Service` - `Medical and Health` - `Non-profit` - `Online Gambling` - `OTC Drugs` - `Other` - `Physical Gambling` - `Professional Services` - `Public Service` - `Restaurant` - `Shopping and Retail` - `Travel and Transportation`
    - `websites` unknown
    - `emails` unknown
    - `phone_numbers` unknown

## Response `202`

Accepted

- MessagingV2ChannelsSenderResponse
  - `sid` string, nullable — The SID of the sender.
  - `status` 'CREATING' | 'ONLINE' | 'OFFLINE' | 'PENDING_VERIFICATION' | 'VERIFYING' | 'ONLINE:UPDATING' | 'TWILIO_REVIEW' | 'DRAFT' | 'STUBBED' — The status of the sender.
  - `sender_id` string, nullable — The ID of the sender in `whatsapp:<E.164_PHONE_NUMBER>` format.
  - `friendly_name` string, nullable — Optional display label for the sender in the Twilio Console.
  - `configuration` MessagingV2ChannelsSenderConfiguration, nullable — The configuration settings for creating a sender.
    - `waba_id` string, nullable — The ID of the WhatsApp Business Account (WABA) to use for this sender.
    - `verification_method` 'sms' | 'voice', nullable — The verification method.
    - `verification_code` string, nullable — The verification code.
    - `voice_application_sid` string, nullable — The SID of the Twilio Voice application.
    - `account_type` 'ISV' | 'ISVSubAccount', nullable — The account type for ISV Account Type Migration. Set to 'ISV' or 'ISVSubAccount' to configure, empty string to clear, or omit to preserve the existing value.
  - `webhook` MessagingV2ChannelsSenderWebhook, nullable — The configuration settings for webhooks.
    - `callback_url` string, nullable — The URL to send the webhook to.
    - `callback_method` 'POST' | 'PUT', nullable — The HTTP method for the webhook.
    - `fallback_url` string, nullable — The URL to send the fallback webhook to.
    - `fallback_method` 'POST' | 'PUT', nullable — The HTTP method for the fallback webhook.
    - `status_callback_url` string, nullable — The URL to send the status callback to.
    - `status_callback_method` string, nullable — The HTTP method for the status callback.
  - `profile` MessagingV2ChannelsSenderProfileGenericResponse, nullable — The profile information for the sender.
    - `name` string, nullable — The name of the sender.
    - `about` string, nullable — The profile about text for the sender.
    - `address` string, nullable — The address of the sender.
    - `description` string, nullable — The description of the sender.
    - `logo_url` string, nullable — The logo URL of the sender.
    - `banner_url` string, nullable — The banner URL of the sender.
    - `privacy_url` string, nullable — The privacy URL of the sender. Must be a publicly accessible HTTP or HTTPS URI associated with the sender.
    - `terms_of_service_url` string, nullable — The terms of service URL of the sender.
    - `accent_color` string, nullable — The color theme of the sender. Must be in hex format and have at least a 4:5:1 contrast ratio against white.
    - `use_case` 'PROMOTIONAL' | 'TRANSACTIONAL' | 'OTP' | 'MULTI_USE', nullable — The messaging use case type for the RCS sender. Allowed values are `PROMOTIONAL`, `TRANSACTIONAL`, `OTP`, `MULTI_USE`. Defaults to `MULTI_USE` if not provided. Cannot be modified after launch.
    - `vertical` string, nullable — The vertical of the sender. Allowed values are: - `Alcohol` - `Automotive` - `Beauty, Spa and Salon` - `Clothing and Apparel` - `Education` - `Entertainment` - `Event Planning and Service` - `Finance and Banking` - `Food and Grocery` - `Hotel and Lodging` - `Matrimony Service` - `Medical and Health` - `Non-profit` - `Online Gambling` - `OTC Drugs` - `Other` - `Physical Gambling` - `Professional Services` - `Public Service` - `Restaurant` - `Shopping and Retail` - `Travel and Transportation`
    - `websites` object[], nullable — The websites of the sender.
      - `website` string
      - `label` string
    - `emails` object[], nullable — The emails of the sender.
      - `email` string
      - `label` string
    - `phone_numbers` object[], nullable — The phone numbers of the sender.
      - `phone_number` string
      - `label` string
  - `properties` MessagingV2ChannelsSenderProperties, nullable — The additional properties for the sender.
    - `quality_rating` string, nullable — The quality rating of the sender.
    - `messaging_limit` string, nullable — The messaging limit of the sender.
  - `offline_reasons` MessagingV2ChannelsSenderOfflineReasonsItems[], nullable — The reasons why the sender is offline.
    - `code` string, nullable — The error code.
    - `message` string, nullable — The error message.
    - `more_info` string, uri, nullable — The URL to get more information about the error.
  - `compliance` MessagingV2RcsComplianceResponse, nullable — The KYC compliance information. This section consists of response to the request launch.
    - `registration_sid` string, required — The default compliance registration SID (e.g., from CR-Google) that applies to all countries unless overridden in the `countries` array.
    - `countries` MessagingV2RcsComplianceCountryResponse[] — A list of country-specific compliance details.
      - `country` string, required — The ISO 3166-1 alpha-2 country code.
      - `registration_sid` string — The default compliance registration SID (e.g., from CR-Google) that applies to all countries unless overridden in the `countries` array.
      - `status` 'ONLINE' | 'OFFLINE' | 'TWILIO_REVIEW' | 'PENDING_VERIFICATION' — The country-level status. Based on the aggregation of the carrier-level status.
      - `carriers` MessagingV2RcsCarrier[]
        - `name` string — The name of the carrier. For example, `Verizon` or `AT&T` for US.
        - `status` 'UNKNOWN' | 'UNLAUNCHED' | 'CARRIER_REVIEW' | 'APPROVED' | 'REJECTED' | 'SUSPENDED' — The carrier-level status.
  - `url` string, uri, nullable — The URL of the resource.

## Changes

- **2026-08-11** (v2) `1b0133a1cf72` — 2 info
  - added the new optional request property `friendly_name`
  - added the optional property `friendly_name` to the response with the `202` status
- **2026-05-06** (v2) `6742cbe164c1` — 2 info
  - added the new optional request property `profile/use_case`
  - added the optional property `profile/use_case` to the response with the `202` status
- **2026-03-24** (v2) `06dce5b2c19b` — 2 info
  - added the new optional request property `configuration/account_type`
  - added the optional property `configuration/account_type` to the response with the `202` status
- **2025-10-28** (v2) `99df3f364d3e` — 3 breaking
  - the response property `compliance/countries` became optional for the status `202`
  - the response property `compliance/countries/items/registration_sid` became optional for the status `202`
  - the response property `compliance/countries/items/status` became optional for the status `202`
- **2025-09-18** (v2) `0dee04926496` — 1 warning
  - added the new `STUBBED` enum value to the `status` response property for the response status `202`

[Full history](https://skmtc.dev/twilio/apis/twilio-messaging/changes/v2/Channels/Senders/:Sid/post.md)

---

[API](https://skmtc.dev/twilio/apis/twilio-messaging.md) · [All operations](https://skmtc.dev/twilio/apis/twilio-messaging/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/twilio-messaging/revisions/1b0133a1cf72?raw)