Sign in

v2

latestOpenAPI 3.0.1raw.githubusercontent.com2026-05-072126235.6 KB
ConversationsV2Configuration

Create a Configuration

Create a new Configuration

post/v2/ControlPlane/Configurations

Headers

Idempotency-Keystring

Client-generated UUID key to ensure idempotent behavior. Submitting the same key returns the original response without creating a duplicate operation. Keys are scoped to account + region with a 24-hour TTL.

Request body

displayNamestring required

A human-readable name for the configuration. Limited to 32 characters.

descriptionstring required

Human-readable description for the configuration.

conversationGroupingType'GROUP_BY_PROFILE' | 'GROUP_BY_PARTICIPANT_ADDRESSES' | 'GROUP_BY_PARTICIPANT_ADDRESSES_AND_CHANNEL_TYPE' required

The strategy Conversation Orchestrator uses to assign communications to conversations.

memoryStoreIdstring required

The memory store ID that Conversation Orchestrator uses for profile resolution.

channelSettingsobject
intelligenceConfigurationIdsstring[]

A list of Conversational Intelligence configuration IDs.

memoryExtractionEnabledboolean

Whether memory extraction is enabled for conversations under this configuration. Defaults to false.

Example request

{
  "displayName": "My Support Config",
  "description": "Customer Support Configuration for handling all inbound customer inquiries",
  "conversationGroupingType": "GROUP_BY_PROFILE",
  "memoryStoreId": "memora_service_123",
  "intelligenceConfigurationIds": [
    "agent1",
    "agent2"
  ]
}

Response

Accepted - Operation created for asynchronous processing

statusUrlstring uri required

URL to poll for operation status.

relatedobject nullable

Named resource identifiers associated with this operation. Keys depend on the operation type:

  • config-create, config-update, config-delete: configurationId
  • conversation-delete: conversationId

Example response

{
  "statusUrl": "https://conversations.twilio.com/v2/ControlPlane/Operations/proc_job_01h9d8r0vte3hz8tykdj329t7r",
  "related": {
    "configurationId": "cfg_configuration_01h9d8r0vte3hz8tykdj329t7r"
  }
}