create_conversation
Create a new conversation in the support desk by providing subject, message, inbox, contact email, and name, with optional team or agent assignment.
Instructions
Create Conversation POST /api/v1/conversations Tags: Conversations
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subject": "<subject>",
"content": "<content>",
"inbox_id": "<inbox_id>",
"contact_email": "<contact_email>",
"first_name": "<first_name>",
"last_name": "<last_name>",
"initiator": "<initiator>"
},
"name": "create_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subject | Yes | (body) Conversation subject | |
| content | Yes | (body) Initial message content (Accepts HTML as well) | |
| inbox_id | Yes | (body) Inbox ID for the conversation | |
| team_id | No | (body) Team ID to be assigned when conversation is created | |
| agent_id | No | (body) Agent ID to be assigned when conversation is created | |
| contact_email | Yes | (body) Contact's email address | |
| first_name | Yes | (body) Contact's first name | |
| last_name | Yes | (body) Contact's last name | |
| attachments | No | (body) Array of attachment IDs | |
| initiator | Yes | (body) Who initiated the conversation. 'contact' means first message is incoming from contact, 'agent' means first message is outgoing from agent |