---
title: "Create a new address configuration"
method: POST
path: "/v1/Configuration/Addresses"
tags: ["ConversationsV1AddressConfiguration"]
---

# Create a new address configuration

`POST /v1/Configuration/Addresses`

Create a new address configuration

## Response `201`

Created

- ConversationsV1ConfigurationAddress
  - `sid` string, nullable — A 34 character string that uniquely identifies this resource.
  - `account_sid` string, nullable — The unique ID of the [Account](https://www.twilio.com/docs/iam/api/account) the address belongs to
  - `type` string, nullable — Type of Address, value can be `whatsapp` or `sms`.
  - `address` string, nullable — The unique address to be configured. The address can be a whatsapp address or phone number
  - `friendly_name` string, nullable — The human-readable name of this configuration, limited to 256 characters. Optional.
  - `auto_creation` unknown
  - `date_created` string, date-time, nullable — The date that this resource was created.
  - `date_updated` string, date-time, nullable — The date that this resource was last updated.
  - `url` string, uri, nullable — An absolute API resource URL for this address configuration.
  - `address_country` string, nullable — An ISO 3166-1 alpha-2n country code which the address belongs to. This is currently only applicable to short code addresses.

## Changes

- **2025-07-03** (v1) `92d1169c37c2` — 3 breaking, 2 info
  - removed the enum value `GET` of the request property `AutoCreation.WebhookMethod`
  - removed the enum value `POST` of the request property `AutoCreation.WebhookMethod`
  - the `auto_creation` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - added the new `get` enum value to the request property `AutoCreation.WebhookMethod`
  - …1 more
- **2025-03-11** (v1) `b4d0e634cd69` — 1 breaking, 1 info
  - the `auto_creation` response's property type/format changed from ``/`` to `object`/`` for status `201`
  - added the new `chat` enum value to the request property `Type`
- **2025-01-28** (v1) `a7fe8595400c` — 1 info
  - added the new `apple` enum value to the request property `Type`
- **2025-01-09** (v1) `9ede5d46a7fa` — 1 info
  - added the new `rcs` enum value to the request property `Type`
- **2023-09-21** (v1) `bf66b70e986b` — 1 info
  - added the new `email` enum value to the request property `Type`

[Full history](https://skmtc.dev/twilio/apis/conversations-v1/changes/v1/Configuration/Addresses/post.md)

---

[API](https://skmtc.dev/twilio/apis/conversations-v1.md) · [All operations](https://skmtc.dev/twilio/apis/conversations-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/conversations-v1/revisions/6a37056c7727/schema)