API Reference5 min read · Updated 2026-06-01

Conversations API

List inbox conversations, retrieve thread details, assign agents, and resolve conversations programmatically.

Conversations represent ongoing message threads between your team and a contact. Use this API to integrate BuzzBip inbox operations into your helpdesk or CRM.

Endpoints

Method	Endpoint	Description
`GET`	`/conversations`	List conversations with filters
`GET`	`/conversations/{id}`	Retrieve a conversation by ID
`POST`	`/conversations/{id}/assign`	Assign a conversation to a team member
`POST`	`/conversations/{id}/resolve`	Mark a conversation as resolved

List conversations

Filter by status, assignee, channel, or contact. Supports cursor pagination.

bash

curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.buzzbip.com/v1/conversations?status=open&limit=25"

Query parameters

Parameter	Type	Description
status	string	Filter by <code>open</code>, <code>pending</code>, or <code>resolved</code>
assigneeId	string	Filter by assigned team member ID
contactId	string	Filter by contact ID
channel	string	Filter by channel (e.g. <code>whatsapp</code>)
limit	integer	Page size (default 25, max 100)
cursor	string	Pagination cursor from a previous response

Assign a conversation

json

// POST /conversations/{id}/assign
{
  "assigneeId": "usr_agent789"
}

Resolve a conversation

Mark a conversation as resolved when the issue is closed. Resolved conversations can be reopened automatically when the contact sends a new message.

bash

curl -X POST "https://api.buzzbip.com/v1/conversations/conv_xyz789/resolve" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Comments API →

Method

Endpoint

Description

GET

/conversations

List conversations with filters

GET

/conversations/{id}

Retrieve a conversation by ID

POST

/conversations/{id}/assign

Assign a conversation to a team member

POST

/conversations/{id}/resolve

Mark a conversation as resolved

Query parameters

Parameter	Type	Description
status	string	Filter by <code>open</code>, <code>pending</code>, or <code>resolved</code>
assigneeId	string	Filter by assigned team member ID
contactId	string	Filter by contact ID
channel	string	Filter by channel (e.g. <code>whatsapp</code>)
limit	integer	Page size (default 25, max 100)
cursor	string	Pagination cursor from a previous response

Resolve a conversation

Mark a conversation as resolved when the issue is closed. Resolved conversations can be reopened automatically when the contact sends a new message.

bash

curl -X POST "https://api.buzzbip.com/v1/conversations/conv_xyz789/resolve" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Comments API →

Conversations API

Endpoints

List conversations

Query parameters

Assign a conversation

Resolve a conversation

Need help with your integration?

Conversations API

Endpoints

List conversations

Query parameters

Assign a conversation

Resolve a conversation

Need help with your integration?