Skip to content

Repository files navigation

Chatwoot (chatwoot-com)

About this repository

This is not our API. This repository is an independent, third-party profile of a company's publicly available API surface, maintained by API Evangelist. API Evangelist does not operate, host, resell, or support this company's APIs, and is not affiliated with or endorsed by the company unless stated on the profile.

Where the information came from. Everything here is assembled from material a member of the public can reach with a browser and no credentials — the company's own website, developer portal and documentation, the specifications it publishes for public use (OpenAPI, AsyncAPI, JSON Schema, apis.json, llms.txt and similar), its public repositories, and its public status, pricing and changelog pages. Nothing here is obtained by breaching a system, defeating an access control, or using credentials of any kind.

The rating is an independent assessment. The Kin Score and Agent Readiness rating are independently calculated scores of a company's public API artifacts, produced by API Evangelist against a published rubric. They are not certifications, endorsements, security assessments, or audits, and they score published artifacts — not the quality, safety, or security of the software.

Corrections, re-scores, and removal are free. No partnership, contract, or purchase is required, and you do not need to justify the request.

  • Something wrong? Open an issue on this repository, or email info@apievangelist.com.
  • Published something new? Ask for a re-score and we will re-run the rating.
  • Want the listing taken down? Say so and we will honor it. The profile is reduced to your company name, a factual description, and a link to your own site, and the company is recorded as unrated — never scored zero for having asked.

Response times. Acknowledgement within one business day; removal or restriction within two business days; corrections and re-scores within five business days.

On a security or compliance team? Email info@apievangelist.com with security in the subject line and you will get a person, not a form. We will tell you exactly which public URLs this profile was built from so your team can see the same surface we did, and we will take the listing down on request while you work through it.

Full detail: Where this data comes from

Chatwoot is an open-source customer engagement and support suite that unifies email, live-chat, social, and messaging channels into a single shared inbox. Agents, teams, contacts, conversations, and messages are all managed through a REST API surface split across an Application API, a Client API for end-user widgets, and a Platform API for super-admin installation control. Chatwoot is available as self-hostable open-source software and as Chatwoot Cloud.

APIs.json: https://raw.githubusercontent.com/api-evangelist/chatwoot-com/refs/heads/main/apis.yml

Tags

  • Customer Support
  • Customer Engagement
  • Shared Inbox
  • Live Chat
  • Open Source
  • Omnichannel
  • Help Desk

Timestamps

  • Created: 2026-07-01
  • Modified: 2026-07-01

Authentication

Application and Platform API requests authenticate with an api_access_token HTTP header (an agent/user token for the Application API, a Platform App token for the Platform API). Client API requests are scoped by an inbox identifier and a contact identifier / pubsub token rather than a static header key. Chatwoot Cloud is served from https://app.chatwoot.com; for self-hosted installations substitute your own host.

APIs

Chatwoot Application Agents API

Manage agents within an account - list, add, update the role and availability of, and remove agents who staff the shared inbox.

Tags

  • Agents
  • Application API

Properties

Chatwoot Application Teams API

Create and manage teams and their agent membership so conversations can be routed to the right group of agents.

Tags

  • Teams
  • Application API

Properties

Chatwoot Application Inboxes API

List, create, update, and delete inboxes across channels (website live-chat, email, and social/messaging), and manage the agents assigned to each inbox.

Tags

  • Inboxes
  • Channels
  • Application API

Properties

Chatwoot Application Contacts API

Manage contacts - create, list, search, filter, update, and delete the people who reach out, plus list a contact's conversations, contactable inboxes, and labels.

Tags

  • Contacts
  • CRM
  • Application API

Properties

Chatwoot Application Conversations API

Create and manage conversations - list with filters, toggle status, assign to agents or teams, update priority, and manage conversation labels and custom attributes.

Tags

  • Conversations
  • Application API

Properties

Chatwoot Application Messages API

Create, list, and delete messages within a conversation, including outgoing agent replies, private notes, and attachments.

Tags

  • Messages
  • Application API

Properties

Chatwoot Application Labels API

List the account's labels and read or set the labels applied to individual conversations and contacts for organization and reporting.

Tags

  • Labels
  • Application API

Properties

Chatwoot Application Custom Attributes API

Define and manage custom attribute definitions for conversations and contacts so installation-specific data can be captured and filtered on.

Tags

  • Custom Attributes
  • Application API

Properties

Chatwoot Application Canned Responses API

Manage canned responses (saved replies) - list, create, update, and delete the short-code reply templates agents use to answer faster.

Tags

  • Canned Responses
  • Application API

Properties

Chatwoot Application Automation Rules API

Create and manage automation rules that fire on events (conversation created, updated, message created) to auto-assign, label, and act on conversations from conditions.

Tags

  • Automation
  • Rules
  • Application API

Properties

Chatwoot Application Reports API

Retrieve account-level and agent/team/inbox/label-level metrics - conversation counts, incoming/outgoing volume, resolution and response times, and conversation summary reports.

Tags

  • Reports
  • Analytics
  • Application API

Properties

Chatwoot Client Contacts API

End-user (widget-facing) API to create and update the contact tied to an inbox identifier, returning a pubsub token used to authenticate that contact's subsequent client requests.

Tags

  • Client API
  • Contacts
  • Widget

Properties

Chatwoot Client Conversations API

End-user API for a contact to create and list their conversations and to toggle status, toggle typing, and update last-seen from within a custom chat interface.

Tags

  • Client API
  • Conversations
  • Widget

Properties

Chatwoot Client Messages API

End-user API for a contact to create, list, and update messages in their conversation, powering a fully custom chat widget on top of Chatwoot.

Tags

  • Client API
  • Messages
  • Widget

Properties

Chatwoot Platform Users API

Super-admin API to create, read, update, and delete users across an installation and to obtain a single-sign-on login URL for a user.

Tags

  • Platform API
  • Users
  • Administration

Properties

Chatwoot Platform Accounts API

Super-admin API to provision and manage accounts on an installation and to manage the association of users to accounts via account users.

Tags

  • Platform API
  • Accounts
  • Administration

Properties

Chatwoot Platform Agent Bots API

Super-admin API to create, read, update, and delete agent bots that can be attached to inboxes to power conversational automation.

Tags

  • Platform API
  • Agent Bots
  • Automation

Properties

Common Properties

Maintainers

FN: Kin Lane Email: kin@apievangelist.com

About

Chatwoot is an open-source customer engagement and support suite that unifies email, live-chat, social, and messaging channels into a single shared inbox. Agents, teams, contacts, conversations, and messages are all managed through a REST API surface split across an Application API, a Client API for end-user widgets, and a Platform API for…

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors