Help Center/Integrations

API Access & External Tools

Connect external tools like Claude Desktop to your SDesk account using the Agent API.

What Is the Agent API?

The Agent API allows external tools to interact with your SDesk helpdesk. This enables:

  • AI assistants like Claude to help triage and respond to tickets
  • Automation tools to process tickets programmatically
  • Custom integrations for your specific workflow

Accessing Your API Key

  1. Go to Settings → API Access
  2. Your API key is displayed (click "Show" to reveal)
  3. Copy the key to use in external tools

Security Best Practices

  • Keep your key secret - Anyone with your key can access your tickets
  • Don't share in public - Never commit API keys to git or share in screenshots
  • Regenerate if compromised - If you suspect your key is leaked, regenerate it immediately
  • Use environment variables - Store keys in secure environment variables, not code

Regenerating Your API Key

If your key is compromised:

  1. Go to Settings → API Access
  2. Click Regenerate API Key
  3. Confirm the action
  4. Update the key in all connected tools

Note: The old key stops working immediately. Update all integrations before regenerating.

What External Tools Can Do

With your API key, external tools can:

  • List and search your support tickets
  • Read full ticket conversations
  • Draft and send replies to customers
  • Add internal notes to tickets
  • Update ticket status
  • Create tickets from external email sources

Rate Limits

API requests are rate-limited to prevent abuse:

  • Requests are subject to fair usage limits
  • Excessive requests may be throttled
  • Contact support if you need higher limits

Available Integrations

Currently supported:

  • Claude Desktop - Connect Claude AI to help manage tickets
  • MCP (Model Context Protocol) - Standard protocol for AI tool integration

See Connecting Claude Desktop for setup instructions.