Address Configuration resource manages the configurations related to a unique address within Conversations
Retrieve a list of address configurations for an account
Query parameters
-
Filter the address configurations by its type. This value can be one of:
whatsapp,sms. -
How many resources to return in each list page. The default is 50, and the maximum is 50.
Minimum value is
1, maximum value is50. -
The page index. This value is simply for client state.
Minimum value is
0. -
The page token. This is provided by the API.
GET
/v1/Configuration/Addresses
curl \
--request GET 'https://conversations.twilio.com/v1/Configuration/Addresses' \
--user "username:password"
Response examples (200)
Read all
{
"meta": {
"page": 0,
"page_size": 50,
"first_page_url": "https://conversations.twilio.com/v1/Configuration/Addresses?PageSize=50&Page=0",
"previous_page_url": null,
"url": "https://conversations.twilio.com/v1/Configuration/Addresses?PageSize=50&Page=0",
"next_page_url": null,
"key": "address_configurations"
},
"address_configurations": [
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"address": "+37256123457",
"type": "sms",
"friendly_name": "My Test Configuration",
"address_country": "CA",
"auto_creation": {
"enabled": true,
"type": "webhook",
"conversation_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"webhook_url": "https://example.com",
"webhook_method": "POST",
"webhook_filters": [
"onParticipantAdded",
"onMessageAdded"
]
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
"address": "+37256123458",
"type": "sms",
"friendly_name": "Studio Test Configuration",
"address_country": "US",
"auto_creation": {
"enabled": false,
"type": "studio",
"conversation_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"studio_flow_sid": "FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"studio_retry_count": 3
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
},
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac",
"address": "+37256123459",
"type": "sms",
"friendly_name": "Default Test Configuration",
"address_country": "NG",
"auto_creation": {
"enabled": true,
"type": "default"
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac"
}
]
}
{
"meta": {
"page": 0,
"page_size": 50,
"first_page_url": "https://conversations.twilio.com/v1/Configuration/Addresses?PageSize=50&Page=0",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses?PageSize=50&Page=0",
"previous_page_url": null,
"next_page_url": null,
"key": "address_configurations"
},
"address_configurations": []
}
{
"meta": {
"page": 0,
"page_size": 50,
"first_page_url": "https://conversations.twilio.com/v1/Configuration/Addresses?Type=sms&PageSize=50&Page=0",
"previous_page_url": null,
"url": "https://conversations.twilio.com/v1/Configuration/Addresses?Type=sms&PageSize=50&Page=0",
"next_page_url": null,
"key": "address_configurations"
},
"address_configurations": [
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"address": "+37256123457",
"type": "sms",
"friendly_name": "My Test Configuration",
"address_country": "CA",
"auto_creation": {
"enabled": true,
"type": "webhook",
"conversation_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"webhook_url": "https://example.com",
"webhook_method": "POST",
"webhook_filters": [
"onParticipantAdded",
"onMessageAdded"
]
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
},
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab",
"address": "+37256123458",
"type": "sms",
"friendly_name": "Studio Test Configuration",
"address_country": "US",
"auto_creation": {
"enabled": false,
"type": "studio",
"conversation_service_sid": "ISaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"studio_flow_sid": "FWaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"studio_retry_count": 3
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaab"
},
{
"account_sid": "ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"sid": "IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac",
"address": "+37256123459",
"type": "sms",
"friendly_name": "Default Test Configuration",
"address_country": "NG",
"auto_creation": {
"enabled": true,
"type": "default"
},
"date_created": "2016-03-24T21:05:50Z",
"date_updated": "2016-03-24T21:05:50Z",
"url": "https://conversations.twilio.com/v1/Configuration/Addresses/IGaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaac"
}
]
}