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.