Create conversation
POST/omnichannel/conversations
Opens a new omnichannel conversation on the specified channel. Use this when receiving an inbound contact via an external adapter or when manually creating a conversation from the agent inbox. The conversation_key field can be supplied by the external system for idempotent creation; if omitted, a random 16-character key is generated.
Request
Responses
- 201
- 422
Conversation created successfully.
Validation failed — check channel enum, foreign key IDs, or date formats.