⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
⌘ K

Search

Search portal content

AI customer support in one tabAI customer support in one tab
  • Use the initdesk API
  • Set up webhooks
  • Use the MCP server
  1. Home
  2. Integrations

Use the initdesk API

Create an integration token, find your organization ID, and send your first request. The full endpoint reference is on developers.initdesk.com.

Use the initdesk API

Create an integration token, find your organization ID, and send your first request. The full endpoint reference is on developers.initdesk.com.

Use the API when another system needs to read or change initdesk data: create tickets from a form or a monitoring tool, sync customers with your CRM, or export tickets to your own reports. This page gets you to a first request. It isn't the reference. Endpoints, fields, and examples are in the developer reference.

Before you start

You need to be an account owner or admin. The API page doesn't appear for other roles.

Create an integration token

An integration token lets a script or a service call the API for one organization.

  1. Open Settings > API.
  2. Select Create token.
  3. Give the token a name you'll recognize later, such as "Production CRM sync". It can be up to 120 characters.
  4. Select Create.
  5. Select Copy token, and store it in a safe place. Then select Done.

initdesk shows the full token only once. If you lose it, delete the token and create a new one.

A token works only for the organization where you created it. To work with another organization, switch to it and create a token there.

Find your organization ID

Most API paths include your numeric organization ID. It's at the top of Settings > API, under Organization ID:. Select it to copy it. Don't use the organization name or the ID in your app's URL.

Send your first request

Send the token in the X-Initdesk-Token header on every request. Use HTTPS. The public API lives at https://api.initdesk.com.

1
2curl https://api.initdesk.com/organizations/ORGANIZATION_ID/tickets/ \
  -H "X-Initdesk-Token: YOUR_TOKEN"

If you get a list of tickets back, you're set up. For other endpoints, fields, and filters, use the developer reference. The Docs button on the API page opens the same site.

Delete a token

Delete a token when you no longer use it or if it may have leaked.

  1. Open Settings > API.
  2. Find the token and select Delete.
  3. Confirm in the Delete integration token dialog.

Anything that uses the token stops working right away. You can't undo it. Create a new token and update your integration.

How it behaves

  • A token can't create or delete other tokens. Only people with an owner or admin role can do that in the app.
  • Each organization can have a limited number of tokens. If you see "You have reached the maximum number of integration tokens.", delete one you don't use.
  • The API is for calling initdesk on demand. To have initdesk send events to you, use webhooks. To work from an AI assistant, use MCP.

If something's not working

If requests return "Invalid integration token."

The token is missing, mistyped, or deleted. Check that you send it in the X-Initdesk-Token header and that you copied the whole token. If you've lost it, create a new one.

If requests return "Inactive integration token."

The token has been turned off. Create a new token.

If the organization can't be found

Use the numeric organization ID from Settings > API, not the organization name.

If it works on your computer but fails in production

Check that production uses the same token and the same base URL. Then check status.initdesk.com for an incident.

Related

  • Set up webhooks
  • Use the MCP server
  • Bring your own data
Help center analytics

See page views, searches, searches with no results, and AI chat activity for your help center, and use them to decide which articles to write next.

Set up webhooks

Have initdesk send a JSON message to your URL when a ticket is created, replied to, assigned, or resolved. Set it up and check each delivery.

Powered by initdesk
On this page
  • Use the initdesk API
  • Before you start
  • Create an integration token
  • Find your organization ID
  • Send your first request
  • Delete a token
  • How it behaves
  • If something's not working
  • If requests return "Invalid integration token."
  • If requests return "Inactive integration token."
  • If the organization can't be found
  • If it works on your computer but fails in production
  • Related