Create a chat
POST /v0/create-chat
Create a single or group chat on a specific account using participant IDs and optional title. Use POST /v1/chats instead.
Request Body
Section titled “Request Body ”object
Account to create the chat on.
Chat type to create: ‘single’ requires exactly one participantID; ‘group’ supports multiple participants and optional title.
User IDs to include in the new chat.
Optional title for group chats; ignored for single chats on most platforms.
Optional first message content if the platform requires it to create the chat.
Responses
Section titled “ Responses ”Tool executed successfully
object
Newly created chat if available.
Example
!NCdzlIaMjZUmvmvyHU:beeper.comInvalid request parameters
object
Error message
Error code
Additional error details
object
Access token is missing or invalid
object
Error message
Error code
Additional error details
object
Access token does not have the required scope
object
Error message
Error code
Additional error details
object
Resource not found
object
Error message
Error code
Additional error details
object
Unprocessable entity - validation error
object
Error message
Error code
Additional error details
object
Too many requests - rate limit exceeded
object
Error message
Error code
Additional error details
object
Internal server error
object
Error message
Error code
Additional error details