> For the complete documentation index, see [llms.txt](https://docs.epic-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.epic-ai.com/api-dokumentation/inbox-conversations.md).

# Inbox Conversations

## Creates a new inbox conversation

> \
> \
> \*\*Required Permission:\*\* \`chatbots.inbox.conversations.create\`\
> \
> \*\*Resource:\*\* \`chatbots/:chatbotId\`

```json
{"openapi":"3.0.0","info":{"title":"ChatCaptain API","version":"1.0"},"tags":[{"name":"Inbox conversations","description":""}],"servers":[{"url":"https://api.chatcaptain.com","description":"Production"}],"security":[{},{}],"paths":{"/v1/inbox/{chatbotId}/conversations":{"post":{"operationId":"InboxConversationController_createConversation[1]_v1","parameters":[{"name":"chatbotId","required":true,"in":"path","description":"The ID of the chatbot.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInboxConversationRequestDto"}}}},"responses":{"201":{"description":"Conversation created successfully.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInboxConversationResponseDto"}}}},"400":{"description":"Invalid input data."},"403":{"description":"Insufficient permissions."}},"summary":"Creates a new inbox conversation","tags":["Inbox conversations"],"description":"\n\n**Required Permission:** `chatbots.inbox.conversations.create`\n\n**Resource:** `chatbots/:chatbotId`"}}},"components":{"schemas":{"CreateInboxConversationRequestDto":{"type":"object","properties":{"name":{"type":"string","description":"The name of the contact for the new conversation."},"email":{"type":"string","format":"email","description":"The email address of the contact."},"phone":{"type":"string","description":"The phone number of the contact."},"channelId":{"type":"string","description":"The ID of the channel in which the conversation is created."}},"required":["name","channelId"]},"CreateInboxConversationResponseDto":{"type":"object","properties":{"conversationId":{"type":"string","description":"The ID of the newly created conversation."},"error":{"type":"string","description":"Optional error message."}}}}}}
```