API access

Use initdesk API to connect to internal systems

Connecting via API

When developing with initdesk, it is important to distinguish between our BYOD (Bring Your Own Data) plugins and our Public API.

BYOD plugin is a UI and AI context extension. They allow you to pull real-time data from external databases directly into a custom card in the agent sidebar during a ticket conversation, being visible also for AI agents. See more info.](https://help.initdesk.com/plugins/byod-bring-your-own-data)
API integration is a system-level tool. It allows your external applications to programmatically create, read, update, and delete core initdesk objects (tickets, contacts, organizations) on demand.

For exact endpoint specifications, rate limits, and authentication headers, see the initdesk Developer Reference.

Automated Incident Logging: Trigger support tickets automatically from external infrastructure monitoring or alerting platforms when system errors occur.
Workflow Automation: Update ticket statuses, assign owners, or append internal notes when an engineer changes an issue status in an external project tracker.

CRM Alignment: Keep user records, subscription tiers, and customer preferences consistent between your central CRM and initdesk.
Bulk Account Updates: Programmatically add tags or update customer organization fields based on external account changes or platform activation milestones.

Data Warehousing: Periodically extract ticket volume, response metrics, and agent conversation data to ingest into business intelligence platforms or data warehouses.

Log into your initdesk dashboard.
Navigate to Settings > Developer Portal.
Generate a new API token. Store this token securely, as it grants complete access to your system data. The API token is only shown once.

All API requests must pass securely over HTTPS. Include your generated token inside the authorization header for every request:

X-Initdesk-Token: {YOUR_API_TOKEN}

Use initdesk API to connect to internal systems

Use initdesk API to connect to internal systems

When developing with initdesk, it is important to distinguish between our BYOD (Bring Your Own Data) plugins and our Public API.

BYOD plugin is a UI and AI context extension. They allow you to pull real-time data from external databases directly into a custom card in the agent sidebar during a ticket conversation, being visible also for AI agents. See more info.](https://help.initdesk.com/plugins/byod-bring-your-own-data)
API integration is a system-level tool. It allows your external applications to programmatically create, read, update, and delete core initdesk objects (tickets, contacts, organizations) on demand.

For exact endpoint specifications, rate limits, and authentication headers, see the initdesk Developer Reference.

Automated Incident Logging: Trigger support tickets automatically from external infrastructure monitoring or alerting platforms when system errors occur.
Workflow Automation: Update ticket statuses, assign owners, or append internal notes when an engineer changes an issue status in an external project tracker.

CRM Alignment: Keep user records, subscription tiers, and customer preferences consistent between your central CRM and initdesk.
Bulk Account Updates: Programmatically add tags or update customer organization fields based on external account changes or platform activation milestones.

Data Warehousing: Periodically extract ticket volume, response metrics, and agent conversation data to ingest into business intelligence platforms or data warehouses.

Log into your initdesk dashboard.
Navigate to Settings > Developer Portal.
Generate a new API token. Store this token securely, as it grants complete access to your system data. The API token is only shown once.

All API requests must pass securely over HTTPS. Include your generated token inside the authorization header for every request:

X-Initdesk-Token: {YOUR_API_TOKEN}