Update a specific sender information like OTP Code, Webhook, Profile information.

POST /v2/Channels/Senders/{Sid}

A Sender resource represents a messaging channel sender of WhatsApp.

Update a specific sender information like OTP Code, Webhook, Profile information.

Path parameters

  • Sid string Required

    A 34 character string that uniquely identifies this Sender.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

application/json

Body

  • configuration object | null

    Configuration settings for creating a sender, e.g., {"waba_id": "1234567890", "verification_method": "sms"}

    Hide configuration attributes Show configuration attributes object | null
    • waba_id string | null

      The ID of the WhatsApp Business Account to use for this sender.

    • verification_method string | null

      The method to use for verification. Either "sms" or "voice".

      Values are sms or voice. Default value is sms.

    • verification_code string | null

      The verification code to use for this sender.

    • voice_application_sid string | null

      The SID of the Twilio Voice application to use for this sender.

  • webhook object | null

    Webhook specific configurations, e.g., {"callback_url": "https://xxx", "callback_method": "POST", "fallback_url": "https://xxx", "fallback_method": "POST", "status_callback_url": "https://xxx", "status_callback_method": "POST"}

    Hide webhook attributes Show webhook attributes object | null
    • callback_url string | null

      The URL to send the webhook to.

    • callback_method string | null

      The HTTP method to use for the webhook. Either "POST" or "PUT".

      Values are POST or PUT.

    • fallback_url string | null

      The URL to send the fallback webhook to.

    • fallback_method string | null

      The HTTP method to use for the fallback webhook. Either "POST" or "PUT".

      Values are POST or PUT.

    • status_callback_url string | null

      The URL to send the status callback to.

    • status_callback_method string | null

      The HTTP method to use for the status callback.

  • profile object | null

    Sender profile specific configurations, e.g., {"name": "xxx", "about": "xxx", "address": "xxx", "description": "xxx", "emails": "xxx@xxx", "logo_url": "https://xxx", "vertical": "xxx", "websites": ["https://xxx", "..."]}

    Hide profile attributes Show profile attributes object | null
    • name string | null

      The name of the sender.

    • about string | null

      The about text of the sender.

    • address string | null

      The address of the sender.

    • description string | null

      The description of the sender.

    • emails

      The emails of the sender.

    • logo_url string | null

      The logo URL of the sender.

    • vertical string | null

      The vertical of the sender. Allowed values are:

      • "Automotive"
      • "Beauty, Spa and Salon"
      • "Clothing and Apparel"
      • "Education"
      • "Entertainment"
      • "Event Planning and Service"
      • "Finance and Banking"
      • "Food and Grocery"
      • "Public Service"
      • "Hotel and Lodging"
      • "Medical and Health"
      • "Non-profit"
      • "Professional Services"
      • "Shopping and Retail"
      • "Travel and Transportation"
      • "Restaurant"
      • "Other"
    • websites

      The websites of the sender.

Responses

  • 202 application/json

    Accepted

    Hide headers attributes Show headers attributes
    • Access-Control-Allow-Origin string

      Specify the origin(s) allowed to access the resource

    • Access-Control-Allow-Methods string

      Specify the HTTP methods allowed when accessing the resource

    • Access-Control-Allow-Headers string

      Specify the headers allowed when accessing the resource

    • Access-Control-Allow-Credentials boolean

      Indicates whether the browser should include credentials

    • Access-Control-Expose-Headers string

      Headers exposed to the client

    • T-Request-Id string
    Hide response attributes Show response attributes object
    • sid string | null

      A 34 character string that uniquely identifies this Sender.

      Minimum length is 34, maximum length is 34. Format should match the following pattern: ^XE[0-9a-fA-F]{32}$.

    • status string

      The Status of this Sender. One of CREATING, ONLINE, OFFLINE, PENDING_VERIFICATION, VERIFYING or ONLINE:UPDATING.

      Values are CREATING, ONLINE, OFFLINE, PENDING_VERIFICATION, VERIFYING, ONLINE:UPDATING, or STUBBED.

    • sender_id string | null

      The ID of this Sender prefixed with the channel, e.g., whatsapp:E.164

    • configuration object | null

      Configuration settings for creating a sender, e.g., {"waba_id": "1234567890", "verification_method": "sms"}

      Hide configuration attributes Show configuration attributes object | null
      • waba_id string | null

        The ID of the WhatsApp Business Account to use for this sender.

      • verification_method string | null

        The method to use for verification. Either "sms" or "voice".

        Values are sms or voice. Default value is sms.

      • verification_code string | null

        The verification code to use for this sender.

      • voice_application_sid string | null

        The SID of the Twilio Voice application to use for this sender.

    • webhook object | null

      Webhook specific configurations, e.g., {"callback_url": "https://xxx", "callback_method": "POST", "fallback_url": "https://xxx", "fallback_method": "POST", "status_callback_url": "https://xxx", "status_callback_method": "POST"}

      Hide webhook attributes Show webhook attributes object | null
      • callback_url string | null

        The URL to send the webhook to.

      • callback_method string | null

        The HTTP method to use for the webhook. Either "POST" or "PUT".

        Values are POST or PUT.

      • fallback_url string | null

        The URL to send the fallback webhook to.

      • fallback_method string | null

        The HTTP method to use for the fallback webhook. Either "POST" or "PUT".

        Values are POST or PUT.

      • status_callback_url string | null

        The URL to send the status callback to.

      • status_callback_method string | null

        The HTTP method to use for the status callback.

    • profile object | null

      Sender profile specific configurations for create and update request, e.g., {"name": "xxx", "about": "xxx", "address": "xxx", "description": "xxx", "emails": [{"label": "email 1", "email": "xxx@xxx"}], "logo_url": "https://xxx", "vertical": "xxx", "websites": [{"label": "email 1", "website": "https://xxx"}]}

      Hide profile attributes Show profile attributes object | null
      • name string | null

        The name of the sender.

      • about string | null

        The about text of the sender.

      • address string | null

        The address of the sender.

      • description string | null

        The description of the sender.

      • emails array[object] | null

        The emails of the sender.

        Hide emails attributes Show emails attributes object
        • email string
        • label string
      • logo_url string | null

        The logo URL of the sender.

      • vertical string | null

        The vertical of the sender. Allowed values are:

        • "Automotive"
        • "Beauty, Spa and Salon"
        • "Clothing and Apparel"
        • "Education"
        • "Entertainment"
        • "Event Planning and Service"
        • "Finance and Banking"
        • "Food and Grocery"
        • "Public Service"
        • "Hotel and Lodging"
        • "Medical and Health"
        • "Non-profit"
        • "Professional Services"
        • "Shopping and Retail"
        • "Travel and Transportation"
        • "Restaurant"
        • "Other"
      • websites array[object] | null

        The websites of the sender.

        Hide websites attributes Show websites attributes object
        • website string
        • label string
    • properties object | null

      Sender specific additional properties, e.g., {"quality_rating": "HIGH", "messaging_limit": "10K Customers/24hr"}

      Hide properties attributes Show properties attributes object | null
      • quality_rating string | null

        The quality rating of the sender.

      • messaging_limit string | null

        The messaging limit of the sender.

    • offline_reasons array[object | null] | null

      Reasons why the sender is offline., e.g., [{"code": "21211400", "message": "Whatsapp business account is banned by provider {provider_name} | Credit line is assigned to another BSP", "more_info": "https://www.twilio.com/docs/errors/21211400"}]

      Hide offline_reasons attributes Show offline_reasons attributes object | null
      • code string | null

        The error code.

      • message string | null

        The error message.

      • more_info string(uri) | null

        The URL to get more information about the error.

    • url string(uri) | null

      The URL of this resource, relative to https://messaging.twilio.com.

POST /v2/Channels/Senders/{Sid}
curl \
 --request POST 'https://messaging.twilio.com/v2/Channels/Senders/{Sid}' \
 --user "username:password" \
 --header "Content-Type: application/json" \
 --data '{"profile":{"name":"Example Business","about":"Example about text","emails":[{"email":"email@email.com","label":"Email"}],"address":"123 Example St, Example City, EX 12345","logo_url":"https://logo_url.com","vertical":"Automotive","websites":[{"label":"Website","website":"https://example.com"},{"label":"Website","website":"http://example.org"}],"description":"Example description"},"webhook":{"callback_url":"https://callback.com","fallback_url":"https://fallback.com","callback_method":"POST","fallback_method":"POST","status_callback_url":"https://statuscallback.com","status_callback_method":"POST"},"configuration":{"verification_code":"123456","voice_application_sid":"APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"}}'
Request example
{
  "profile": {
    "name": "Example Business",
    "about": "Example about text",
    "emails": [
      {
        "email": "email@email.com",
        "label": "Email"
      }
    ],
    "address": "123 Example St, Example City, EX 12345",
    "logo_url": "https://logo_url.com",
    "vertical": "Automotive",
    "websites": [
      {
        "label": "Website",
        "website": "https://example.com"
      },
      {
        "label": "Website",
        "website": "http://example.org"
      }
    ],
    "description": "Example description"
  },
  "webhook": {
    "callback_url": "https://callback.com",
    "fallback_url": "https://fallback.com",
    "callback_method": "POST",
    "fallback_method": "POST",
    "status_callback_url": "https://statuscallback.com",
    "status_callback_method": "POST"
  },
  "configuration": {
    "verification_code": "123456",
    "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}
Response examples (202)
{
  "sid": "XEaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "VERIFYING",
  "profile": {
    "name": "Example Business",
    "about": "Example about text",
    "emails": [
      {
        "email": "email@email.com",
        "label": "Email"
      }
    ],
    "address": "123 Example St, Example City, EX 12345",
    "logo_url": "https://logo_url.com",
    "vertical": "Automotive",
    "websites": [
      {
        "label": "Website",
        "website": "https://example.com"
      },
      {
        "label": "Website",
        "website": "http://example.org"
      }
    ],
    "description": "Example description"
  },
  "webhook": {
    "callback_url": "https://callback.com",
    "fallback_url": "https://fallback.com",
    "callback_method": "POST",
    "fallback_method": "POST",
    "status_callback_url": "https://statuscallback.com",
    "status_callback_method": "POST"
  },
  "sender_id": "whatsapp:+999999999XX",
  "configuration": {
    "waba_id": "1234567XXX",
    "verification_code": null,
    "verification_method": "sms",
    "voice_application_sid": "APaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
  }
}