Export Your Data
Converge Team
Part of the Chatwoot migration guide
Learn how to export your customer data, conversation history, and contacts from Chatwoot before migrating to a new platform.
How to Export Your Data from Chatwoot
Chatwoot does not offer a one-click bulk data export in its dashboard. Instead, you export data through Chatwoot's REST API or by downloading reports from the reporting section.
Export Contacts via API
Use the Contacts API at /api/v1/accounts/{account_id}/contacts to list and paginate through all your contacts. Each contact record includes name, email, phone number, custom attributes, and conversation count. You'll need an agent or admin API access token, which you can generate under Settings › Profile › Access Token. Export results are returned as JSON — you'll need a script or tool to convert to CSV if needed.
Export Conversations and Messages
The Conversations API at /api/v1/accounts/{account_id}/conversations returns conversation metadata (status, assignee, labels, timestamps). To get individual messages, call /api/v1/accounts/{account_id}/conversations/{id}/messages for each conversation. There is no single endpoint that exports all messages in bulk — you need to iterate through conversations one by one. For self-hosted instances, you can also query the PostgreSQL database directly.
Download Reports
Chatwoot offers downloadable reports on Startups plans and above. Navigate to Reports in the sidebar to access conversation, agent, inbox, label, and team reports. These can be downloaded for your records, but they contain aggregated metrics — not raw conversation data. The Hacker (free) plan does not include downloadable reports.
Export Canned Responses and Labels
Canned responses (Chatwoot's equivalent of quick replies) can be listed via /api/v1/accounts/{account_id}/canned_responses. Labels are available at /api/v1/accounts/{account_id}/labels. Document your automation rules and team assignments manually — these are not available through the API and must be recreated in your new platform.
Data Retention Limits
If you're on the Hacker plan, your data is automatically deleted after 30 days. Startups retains for 1 year, Business for 2 years, and Enterprise for 3 years. Export your data before it reaches the retention limit or before canceling your subscription.
Generating Your API Access Token
To use any of Chatwoot's export APIs, you need an access token. Log into Chatwoot, click your avatar in the bottom-left corner, go to Profile Settings, and scroll down to Access Token. Copy the token and use it in your API requests as a header: api_access_token: your_token_here. Admin tokens can access all account data; agent tokens are limited to their assigned conversations.
Tip: If you're on a self-hosted Chatwoot instance, you have full access to the PostgreSQL database and can export everything directly using pg_dump or SQL queries. This is significantly easier than working through the API.
Need the full migration guide?
This page covers export your data specifically. For the complete step-by-step migration process:
Read the complete Chatwoot migration guide →Ready to try Converge?
$49/month flat. Up to 15 agents. 14-day free trial, no credit card required.
Start Free Trial