Export Your Data

Converge Team

• Updated March 12, 2026

Learn how to export your customer data, conversation history, and contacts from Freshchat before migrating to a new platform.

How to Export Your Data from Freshchat

Freshchat does not provide a one-click bulk data export from its admin dashboard. You need to use the Freshchat REST API v2 to retrieve users, conversations, and messages programmatically.

The API is available at https://<your-account>.freshchat.com/v2/ and requires an API token generated from Settings > API Tokens in your Freshchat admin panel. All requests use Bearer token authentication.

Export Contacts (Users)

Use the GET /v2/users endpoint to list all contacts. You can filter by creation date, email, or phone number. The API returns paginated JSON with user properties including name, email, phone, custom properties, and creation timestamps. For a specific subset, use POST /v2/users/fetch with an array of user IDs. Export the JSON responses and convert to CSV externally if needed.

Export Conversation History

Retrieve conversations per user via GET /v2/users/{user_id}/conversations. Each conversation object includes status, assigned agent, group, timestamps, and channel source. To get the actual messages within a conversation, call GET /v2/conversations/{conversation_id}/messages. Messages include sender info, content (text, images, files), and timestamps. This is per-conversation, so exporting a large account requires iterating through all users and their conversations.

Export Agent and Group Data

Use GET /v2/agents to list all agent profiles (name, email, role, status, groups). Use GET /v2/groups to retrieve your team group structure and routing configuration. Use GET /v2/channels (called "Topics" in the API) to export your channel configuration. Document these so you can recreate equivalent structures in your new platform.

What You Cannot Export via API

Freshchat's API does not expose chatbot flows (Freddy AI Agent configurations), IntelliAssign routing rules, CSAT survey templates, or campaign setups. Screenshot your bot flows from the Freddy AI Agent builder and manually document your IntelliAssign settings, auto-resolve rules, and canned response templates before canceling your account.

API Rate Limits

Freshchat's API enforces rate limits that vary by plan. If you have a large volume of conversations, consider spacing your export requests or running the export over multiple sessions. The API returns standard HTTP 429 status codes when limits are hit.

Tip: If you also use Freshdesk alongside Freshchat, ticket data may be accessible through Freshdesk's separate data export feature under Admin > Account > Data Export, which offers CSV downloads for tickets and contacts.