Skip to main content
The Todoist plugin handles incoming webhooks. Point your provider’s subscription URL at your Corsair HTTP handler (see Overview for setup context and the exact URL shape).
New to Corsair? See webhooks and hooks.

​
Webhook map

  • items
    • added (items.added)
    • completed (items.completed)
    • deleted (items.deleted)
    • uncompleted (items.uncompleted)
    • updated (items.updated)
  • notes
    • added (notes.added)
    • deleted (notes.deleted)
    • updated (notes.updated)
  • projects
    • added (projects.added)
    • archived (projects.archived)
    • deleted (projects.deleted)
    • unarchived (projects.unarchived)
    • updated (projects.updated)

​
HTTP handler setup

app/api/webhook/route.ts
import { processWebhook } from "corsair";
import { corsair } from "@/server/corsair";

export async function POST(request: Request) {
    const headers = Object.fromEntries(request.headers);
    const body = await request.json();
    const result = await processWebhook(corsair, headers, body);
    return result.response;
}

​
Events

​
Items

​
Added

items.added A new task was added Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        items: {
            added: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Completed

items.completed A task was completed Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        items: {
            completed: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Deleted

items.deleted A task was deleted Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        items: {
            deleted: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Uncompleted

items.uncompleted A completed task was uncompleted Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        items: {
            uncompleted: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Updated

items.updated A task was updated Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        items: {
            updated: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Notes

​
Added

notes.added A new note/comment was added Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        notes: {
            added: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Deleted

notes.deleted A note/comment was deleted Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        notes: {
            deleted: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Updated

notes.updated A note/comment was updated Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        notes: {
            updated: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Projects

​
Added

projects.added A new project was created Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        projects: {
            added: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Archived

projects.archived A project was archived Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        projects: {
            archived: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Deleted

projects.deleted A project was deleted Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        projects: {
            deleted: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Unarchived

projects.unarchived A project was unarchived Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        projects: {
            unarchived: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})

​
Updated

projects.updated A project was updated Payload: unknown webhookHooks example 
todoist({
    webhookHooks: {
        projects: {
            updated: {
                before(ctx, args) {
                    return { ctx, args };
                },
                after(ctx, response) {
                },
            },
        },
    },
})