---
title: "List Configurations"
method: GET
path: "/v2/ControlPlane/Configurations"
tags: ["ConversationsV2Configuration"]
---

# List Configurations

`GET /v2/ControlPlane/Configurations`

Retrieve a list of Configurations.

## Query parameters

- `pageSize` integer
- `pageToken` string
- `memoryStoreId` string

## Response `200`

OK

- object
  - `configurations` object[], required
    - `id` string, required — Configuration ID.
    - `displayName` string, required — A human-readable name for the configuration. Limited to 32 characters.
    - `description` string, required — Human-readable description for the Configuration. Allows spaces and special characters, typically limited to a paragraph of text. This serves as a descriptive field rather than just a name.
    - `conversationGroupingType` 'GROUP_BY_PROFILE' | 'GROUP_BY_PARTICIPANT_ADDRESSES' | 'GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE', required — Type of Conversation grouping strategy: - `GROUP_BY_PROFILE`: Groups Communications by resolved Profile from the Memory Store. A Profile is looked up or created for `CUSTOMER` Participant types. All Communications from the same Profile are in the same Conversation, regardless of address or channel. - `GROUP_BY_PARTICIPANT_ADDRESSES`: Groups Communications by Participant addresses across all channels. A customer using +18005550100 will be in the same Conversation whether they contact by SMS, WhatsApp, or RCS. - `GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE`: Groups Communications by both Participant addresses AND channel. A customer using +18005550100 by SMS will be in a different Conversation than the same customer by Voice.
    - `memoryStoreId` string, required — Memory Store ID for Profile resolution.
    - `channelSettings` ConversationsV2ConfigurationChannelSettings — Channel-specific configuration settings by channel type. Keys should be valid channel types (`VOICE`, `SMS`, `RCS`, `WHATSAPP`, `CHAT`).
    - `statusCallbacks` ConversationsV2StatusCallbackConfig[] — List of default webhook configurations applied to Conversations under this Configuration.
      - `url` string, uri, required — Destination URL for webhooks.
      - `method` 'POST' | 'GET' — HTTP method used to invoke the webhook URL.
    - `intelligenceConfigurationIds` string[] — A list of Conversational Intelligence configuration IDs.
    - `memoryExtractionEnabled` boolean — Whether memory extraction is enabled for conversations under this configuration. Defaults to false.
    - `conversationsV1Bridge` ConversationsV2ConversationsV1Bridge — Configuration for Conversations V1 bridge. When set, messaging channels route through Conversations V1. Use this to integrate with existing Conversations V1 applications.
      - `serviceId` string, required — The Conversations V1 Service SID (IS prefix). One configuration per V1 Service SID.
    - `createdAt` string, date-time — Timestamp when this Configuration was created.
    - `updatedAt` string, date-time — Timestamp when this Configuration was last updated.
    - `version` integer — Version number used for optimistic locking.
  - `meta` object, required
    - `key` string, required — The key of the list property contains the actual data items
    - `pageSize` integer, required — The actual number of items returned in this response
    - `previousToken` string — Token to fetch the previous page of results
    - `nextToken` string — Token to fetch the next page of results

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable

---

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