Skip to main content

Connectors

Connectors link CTM to external task services. Each connector stores encrypted OAuth tokens and syncs tasks every 15 minutes.

Supported sources​

SourceID
Todoisttodoist
Google Tasksgoogle_tasks

Connecting a source​

1. Get the OAuth URL​

POST /connectors/configs
Authorization: Bearer <token>
Content-Type: application/json

{ "source": "todoist" }

2. Redirect the user​

Open the returned url in a browser. The user authorises CTM; the provider redirects back to /connectors/oauth/callback/:source.

3. Check the connection​

GET /connectors/configs
Authorization: Bearer <token>
[
{
"id": "...",
"source": "todoist",
"enabled": true,
"lastSyncedAt": "2026-05-20T10:00:00.000Z",
"lastError": null
}
]

Enabling / disabling a connector​

PATCH /connectors/configs/:id
Authorization: Bearer <token>
Content-Type: application/json

{ "enabled": false }

Removing a connector​

DELETE /connectors/configs/:id
Authorization: Bearer <token>

Returns 204 No Content. Tasks mirrored from this source remain in CTM.