Update a Subscription

POST /v1/Subscriptions/{Sid}

Subscription to send Event Types to a Sink

Update a Subscription.

Path parameters

  • Sid string Required

    A 34 character string that uniquely identifies this Subscription.

Body

  • Description string

    A human readable description for the Subscription.

  • SinkSid string

    The SID of the sink that events selected by this subscription should be sent to. Sink must be active for the subscription to be created.

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

Responses

  • 200

    OK

    Hide response attributes Show response attributes object
    • account_sid string | null

      Account SID.

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

    • date_created string(date-time) | null

      The date this Subscription was created

    • date_updated string(date-time) | null

      The date this Subscription was updated

    • description string | null

      Subscription description

    • links object(uri-map) | null

      Nested resource URLs.

    • sid string | null

      A string that uniquely identifies this Subscription.

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

    • sink_sid string | null

      Sink SID.

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

    • url string(uri) | null

      The URL of this resource.
POST /v1/Subscriptions/{Sid} 
curl \
 -X POST https://events.twilio.com/v1/Subscriptions/{Sid} \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'Description=string&SinkSid=string'
Request example 
{
  "Description": "string",
  "SinkSid": "string"
}
Request examples 
{
  "Description": "string",
  "SinkSid": "string"
}
Response examples (200) 
{
  "account_sid": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "description": "string",
  "links": {},
  "sid": "string",
  "sink_sid": "string",
  "url": "https://example.com"
}
Response examples (200) 
{
  "account_sid": "string",
  "date_created": "2025-05-04T09:42:00Z",
  "date_updated": "2025-05-04T09:42:00Z",
  "description": "string",
  "links": {},
  "sid": "string",
  "sink_sid": "string",
  "url": "https://example.com"
}