For Agents
Manage Dixa conversations, agents, end users, queues, and analytics, plus configure webhooks and custom attributes through a comprehensive customer service API.
Get started with Dixa API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"list Dixa conversations on a team"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Dixa API API.
Create and update end-user customer profiles for support routing
Pull conversation records and route them to the right team or queue
Manage agents — create, update, set presence, list team membership
Configure queues, teams, tags, and custom attributes that drive routing
Anonymise end users and conversations for GDPR compliance
GET STARTED
Use for: Create a new end-user record in Dixa, List all open conversations for a team, Update an agent's presence to busy, Find all conversations tagged with refund
Not supported: Does not host live chat widgets, voice infrastructure, or knowledge base content directly — use for conversation, agent, and end-user management only.
Jentic publishes the only available OpenAPI document for Dixa API, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for Dixa API, keeping it validated and agent-ready. Dixa is a conversational customer service platform that brings email, chat, voice, and social messages into one agent workspace. The API exposes conversations, agents, end users, teams, queues, tags, custom attributes, analytics, and webhooks, so external systems can sync customer profiles, push messages into the right queue, and pull operational metrics for reporting. Used by brands like Wise, Deezer, and Too Good To Go.
Run analytics queries to pull metrics, filters, and analytics records
Register and manage webhooks to push events to external systems
Patterns agents use Dixa API API for, with concrete tasks.
★ CRM-to-Helpdesk End User Sync
Customer service operations sync end-user records from a CRM into Dixa so agents see full customer context when a conversation arrives. POST /v1/endusers and the bulk variant create or update profiles, while PATCH lets ops keep contact details current. This avoids the agent having to ask basic identity questions during a live conversation.
POST /v1/endusers/bulk with an array of customer profiles pulled from the CRM nightly to keep Dixa end users in sync.
Agent and Team Lifecycle Management
HR and ops teams provision Dixa agents from their identity provider, assigning them to teams as they join or move. The /v1/agents endpoints support create, update, and bulk operations, and /v1/agents/{agentId}/teams returns the agent's team memberships so tools can validate routing changes before applying them.
POST /v1/agents/bulk with the new-hire list and assign each to the right team based on role data from the HR system.
GDPR Anonymisation Workflow
Privacy and legal teams handle GDPR right-to-erasure requests through PATCH /v1/endusers/{userId}/anonymize. This scrubs personally identifying information from the end user record while preserving the conversation history needed for audit. Most teams pair this with a ticketing flow to track each request through to anonymisation.
PATCH /v1/endusers/{userId}/anonymize for each verified GDPR erasure request and log the request ID against the audit trail.
Operational Analytics Pipeline
Support ops teams pull conversation metrics and filter dimensions through the /v1/analytics/metrics, /v1/analytics/records, and /v1/analytics/filter endpoints to drive their own dashboards in BI tools. POSTing to /v1/analytics/metrics or /v1/analytics/records lets teams define the slice they need rather than working off canned reports.
POST /v1/analytics/records with a filter for the past 7 days, then load the returned records into the BI warehouse for a weekly support performance dashboard.
Agent-Driven Customer Service Automation
AI agents help Dixa supervisors triage queues, anonymise users, and pull analytics through Jentic. The Dixa API key sits in the Jentic vault, so the agent can resolve intents like 'list all open conversations for the billing team' without holding credentials.
Search Jentic for 'list Dixa agents on a team', load the GET /v1/agents/{agentId}/teams operation, and execute it for the requested agent ID.
84 endpoints — jentic publishes the only available openapi specification for dixa api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/endusers
Create an end-user record
/v1/endusers/bulk
Bulk-create end-user records
/v1/endusers/{userId}/anonymize
Anonymise an end user for GDPR
/v1/agents
Create an agent
/v1/agents/bulk
Bulk-create agents
/v1/agents/{agentId}/teams
List teams an agent belongs to
/v1/analytics/records
Query analytics records
/v1/agents/presence
List agent presence states
/v1/endusers
Create an end-user record
/v1/endusers/bulk
Bulk-create end-user records
/v1/endusers/{userId}/anonymize
Anonymise an end user for GDPR
/v1/agents
Create an agent
/v1/agents/bulk
Bulk-create agents
Three things that make agents converge on Jentic-routed access.
Credential isolation
The Dixa API key is held encrypted in the Jentic vault. Agents call Dixa through Jentic and never see the raw key — the ApiKeyAuth header is injected at execution time.
Intent-based discovery
Agents search Jentic by intent (e.g. 'list Dixa conversations' or 'anonymise an end user') and Jentic returns the matching Dixa operation with its input schema, so the agent does not browse Dixa's 84-endpoint surface.
Time to first call
Direct Dixa integration: 3-5 days to wire end-user sync, agent provisioning, analytics, and webhooks. Through Jentic: under 1 hour — search, load schema, execute.
Alternatives and complements available in the Jentic catalogue.
Zendesk API
Zendesk is a broader competing helpdesk with a larger ecosystem of apps and integrations.
Choose Zendesk when the team needs the largest marketplace of pre-built integrations; choose Dixa when conversational, multi-channel routing is the priority.
Freshdesk API
Freshdesk is a competing helpdesk strong on ticketing workflows.
Choose Freshdesk when the workflow is ticket-led; choose Dixa when the workflow is conversational across email, chat, voice, and social.
Intercom API
Use Intercom for in-product messaging alongside Dixa for cross-channel support.
Use Intercom for proactive in-app messaging and bots, then hand escalations into Dixa for unified support across channels.
Specific to using Dixa API API through Jentic.
Why is there no official OpenAPI spec for Dixa API?
Dixa does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Dixa API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Dixa API use?
Dixa uses an API key passed in a request header (ApiKeyAuth scheme). Through Jentic the key is stored encrypted in the vault and injected at execution so the raw value never enters agent context.
Can I bulk-create end users with the Dixa API?
Yes — POST /v1/endusers/bulk accepts an array of end-user objects, which is the recommended approach for nightly CRM-to-Dixa syncs over more than a handful of records.
How do I anonymise an end user for GDPR with the Dixa API?
Call PATCH /v1/endusers/{userId}/anonymize. Personally identifying information on the end user record is scrubbed while conversation history is preserved for audit.
What are the rate limits for the Dixa API?
The OpenAPI spec does not declare specific rate limits. For high-volume workloads, prefer bulk endpoints (/v1/endusers/bulk, /v1/agents/bulk) and implement exponential backoff on 429 responses.
How do I pull conversation analytics through Jentic?
Search Jentic for 'query Dixa analytics records', load the POST /v1/analytics/records operation, and execute it with the filter payload. Jentic injects the API key at execution and returns the query results.
/v1/agents/{agentId}/teams
List teams an agent belongs to
/v1/analytics/records
Query analytics records
/v1/agents/presence
List agent presence states