Update an existing address configuration

POST /v1/Configuration/Addresses/{Sid}

Address Configuration resource manages the configurations related to a unique address within Conversations

Update an existing address configuration

Path parameters

  • Sid string Required

    The SID of the Address Configuration resource. This value can be either the sid or the address of the configuration

Body

  • Conversation Service for the auto-created conversation. If not set, the conversation is created in the default service.

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

  • Enable/Disable auto-creating conversations for messages to this address

  • For type studio, the studio flow SID where the webhook should be sent to.

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

  • For type studio, number of times to retry the webhook request

  • Type of Auto Creation. Value can be one of webhook, studio or default.

    Values are webhook, studio, or default.

  • The list of events, firing webhook event for this Conversation. Values can be any of the following: onMessageAdded, onMessageUpdated, onMessageRemoved, onConversationUpdated, onConversationStateUpdated, onConversationRemoved, onParticipantAdded, onParticipantUpdated, onParticipantRemoved, onDeliveryUpdated

  • For type webhook, the HTTP method to be used when sending a webhook request.

    Values are GET or POST.

  • For type webhook, the url for the webhook request.

  • The human-readable name of this configuration, limited to 256 characters. Optional.

Responses

  • OK

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

      The unique ID of the Account the address belongs to.

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

    • address string | null

      The unique address to be configured.

    • Auto Creation configuration for the address.

    • date_created string(date-time) | null

      The date that this resource was created.

    • date_updated string(date-time) | null

      The date that this resource was last updated.

    • friendly_name string | null

      The human-readable name of this configuration.

    • sid string | null

      A 34 character string that uniquely identifies this resource.

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

    • type string | null

      Type of Address.

    • url string(uri) | null

      An absolute URL for this address configuration.

POST /v1/Configuration/Addresses/{Sid}
curl \
 -X POST https://conversations.twilio.com/v1/Configuration/Addresses/{Sid} \
 --user "username:password" \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -d 'AutoCreation.ConversationServiceSid=string&AutoCreation.Enabled=true&AutoCreation.StudioFlowSid=string&AutoCreation.StudioRetryCount=42&AutoCreation.Type=webhook&AutoCreation.WebhookFilters=string&AutoCreation.WebhookMethod=GET&AutoCreation.WebhookUrl=string&FriendlyName=string'
Request example
{
  "AutoCreation.ConversationServiceSid": "string",
  "AutoCreation.Enabled": true,
  "AutoCreation.StudioFlowSid": "string",
  "AutoCreation.StudioRetryCount": 42,
  "AutoCreation.Type": "webhook",
  "AutoCreation.WebhookFilters": [
    "string"
  ],
  "AutoCreation.WebhookMethod": "GET",
  "AutoCreation.WebhookUrl": "string",
  "FriendlyName": "string"
}
Request examples
{
  "AutoCreation.ConversationServiceSid": "string",
  "AutoCreation.Enabled": true,
  "AutoCreation.StudioFlowSid": "string",
  "AutoCreation.StudioRetryCount": 42,
  "AutoCreation.Type": "webhook",
  "AutoCreation.WebhookFilters": [
    "string"
  ],
  "AutoCreation.WebhookMethod": "GET",
  "AutoCreation.WebhookUrl": "string",
  "FriendlyName": "string"
}
Response examples (200)
{
  "account_sid": "string",
  "address": "string",
  "date_created": "2023-05-04T09:42:00+00:00",
  "date_updated": "2023-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "sid": "string",
  "type": "string",
  "url": "https://example.com"
}
Response examples (200)
{
  "account_sid": "string",
  "address": "string",
  "date_created": "2024-05-04T09:42:00+00:00",
  "date_updated": "2024-05-04T09:42:00+00:00",
  "friendly_name": "string",
  "sid": "string",
  "type": "string",
  "url": "https://example.com"
}