API tokens and developer access

Deskwoot provides a REST API that lets you programmatically manage conversations, contacts, messages, and more. Use API tokens to authenticate your requests.

Generating an API token

Go to Settings > API Tokens to create a new token. Give it a descriptive name and set the appropriate permissions. Copy the token immediately after creation - it will not be shown again.

Using the API

Include your API token in the Authorization header of every request: 'Authorization: Bearer YOUR_TOKEN'. The base URL for all API endpoints is https://deskwoot.com/api/v1/. All responses are in JSON format.

Available endpoints

The API covers all major resources: conversations (create, list, update, assign), contacts (CRUD, search, merge), messages (send, list), inboxes, teams, labels, automation rules, reports, and more. Each endpoint supports pagination, filtering, and proper error responses.