Skip to main content
This guide walks you through obtaining all required credentials for the Todoist plugin.

​
Authentication Method

The Todoist plugin uses API key authentication.
  • api_key (default) — Todoist API token used for the REST API

​
API Token

​
Step 1: Copy Your Personal API Token

  1. Log in to Todoist.
  2. Open Settings → Integrations (or Developer / API token depending on the current UI).
  3. Find API token (sometimes called personal API token).
  4. Copy the token — it is unique to your account.
Storing credentials: 
pnpm corsair setup --plugin=todoist api_key=your-api-token
Verify: 
pnpm corsair auth --plugin=todoist --credentials

​
Webhook Secret

Todoist can send webhooks for task and project events. When you register a webhook URL, Todoist provides a client secret or signing material used to verify deliveries (see Todoist’s webhook documentation for the header format).
  1. In Todoist developer settings, create a webhook pointing to your HTTPS endpoint.
  2. Copy the secret associated with that webhook client.
Storing credentials: 
pnpm corsair setup --plugin=todoist webhook_signature=your-webhook-secret

​
Required Credentials Summary

CredentialRequired forWhere to find
API tokenapi_key authTodoist → Settings → Integrations / API
Webhook secretWebhooksTodoist webhook / app registration
For general information about how Corsair handles authentication, see Authentication.