What are Notion Workers?

• Sync external data into Notion databases on a schedule.
• Give Notion AI new tools that your Custom Agents can call.
• Receive webhooks from external services like GitHub, Stripe, or Zendesk.

​

What you can build

Sync data

Pull data from Salesforce, Stripe, GitHub, or any API into Notion databases — kept in sync automatically.

Agent tools

Give Notion Custom Agents functions like “create a Jira ticket” or “look up a customer in our CRM.”

Webhooks

Receive HTTP events from GitHub pushes, Stripe payments, or any service that sends webhooks.

​

How it works

import { Worker } from "@notionhq/workers";

const worker = new Worker();
export default worker;

// Register capabilities on the worker
worker.tool("sayHello", { /* ... */ });
worker.sync("customersSync", { /* ... */ });
worker.webhook("onGithubPush", { /* ... */ });

• Syncs run on a schedule (default every 30 minutes) and write results to Notion databases.
• Tools appear in Notion Custom Agents and are called by agents on demand.
• Webhooks receive HTTP events from external services and run your handler asynchronously.

​

Typical workflow

ntn workers new my-worker
cd my-worker

ntn workers deploy

​

Next steps

Quickstart

Create and deploy your first worker in less than five minutes.

CLI reference

Install and configure the Notion CLI.