Run custom code with Workers (beta)
Learn what Workers are and what they’re used for.
Hopp til vanlige spørsmålNotion Workers are part of our Developer Platform. They run custom code on Notion's infrastructure to power:
Database sync
Tools for Custom Agents
Webhook triggers
For technical setup, see the developer documentation.
For more info about pricing, see this article.
Workers are available on Business and Enterprise plans.
By default, Workers are switched on for the workspace (owners only).
Workspace owners can:
Keep Worker creation to owners only.
Allow specific members or groups to create Workers.
Turn Workers off for the workspace.
If you're trying to deploy or manage a Worker, you’ll typically follow our developer documentation and use the Notion CLI.
You can turn on Developer Mode to view Workers in Notion, read logs, and turn off or delete Workers. To deploy a Worker or change its code or setup, use the Notion CLI or your team’s coding tool. Learn more about developer mode →
To learn more about pricing for Workers, see this article.
Database sync (powered by Workers) brings information from outside tools into a Notion database and keeps it up to date automatically. Once it's set up, the synced database stays current on its own, so your team and your agents always see the latest data without anyone copying or pasting between tools.
A few common examples:
Sync Zendesk support tickets into a triage database.
Sync Salesforce accounts into a pipeline tracker.
Sync data from an internal tool or database.
Once it's live, the synced database behaves like any other database in Notion. Access is governed by your standard Notion sharing permissions.
Agent tools (powered by Workers) extend what your Custom Agents can do beyond Notion's built-in actions and MCP, with capabilities tailored to how your team works.
A few common examples:
Querying a data warehouse.
Generating assets from a Notion doc.
Taking action in another app that isn’t natively supported or available via MCP.
Webhook triggers (powered by Workers) let an event in another tool kick off a workflow in Notion or any other connected system.
A few common examples:
Closing a task when a pull request merges.
Updating a CRM record when a subscription changes.
Creating an onboarding doc when an offer is signed.
Once it's set up, the workflow runs automatically every time the event happens, so your team doesn't have to manually move information between tools.
With Developer Mode, you can open Workers from the developer section in your sidebar. Use this view for quick checks and basic actions. In Notion, you can:
See all Workers in one list.
Open a Worker and view Overview, Logs, Environment Variables, and Settings.
Read Worker logs.
Turn off or delete a Worker.
To deploy a Worker or change its code or setup, use the Notion CLI or your team’s coding tool.
By default, only the person who created a Worker can modify and add it as a new connection. Share a Worker with teammates so they can connect it to a Custom Agent or help manage it.
Try these steps in order:
Make sure your workspace is eligible, and that a workspace owner has turned Workers on. Workers are available on Business and Enterprise plans, and require enablement from a workspace admin.
Confirm you’re using the intended setup path. For most setups, you’ll use Notion CLI plus the developer docs.
If your Worker deploy fails, check permissions next. You may not have access to deploy to that workspace, even if you can view pages in it.
If your Worker runs but doesn’t change anything in Notion, test the action manually first. If you can’t make the same change in Notion, it’s usually a permission or workspace-setting issue.
If cost looks higher than expected, lower the run frequency. Workers that run more often will cost more. Start with a slower schedule, then increase once you’re confident it’s working.
Still stuck? Follow the developer documentation for the specific error message. They’ll have the most accurate fix.
Vanlige spørsmål
Hva er forskjellen på Workers og Skreddersydde agenter?
Hva er forskjellen på Workers og Skreddersydde agenter?
Workers og Skreddersydde agenter løser ulike problemer, men de kan fungere sammen.
Workers: Kjør tilpasset kode på Notions infrastruktur. Utviklere bruker Workers til ting som automaseringer, planlagte synkroniseringer og tilpassede integrasjoner.
Skreddersydde agenter: Håndter rutinearbeid for teamet ditt automatisk. Du setter opp utløsere, og de kjører i bakgrunnen med arbeidsområdet ditt som kontekst.
I enkelte oppsett kan en Worker drive et unikt verktøy som en Skreddersydd agent kan bruke. For eksempel kan en Worker hente data fra et annet system, og agenten kan bruke disse dataene til å svare eller utføre handlinger.
Er Workers det samme som automaseringer?
Er Workers det samme som automaseringer?
Ikke helt. Automaseringer er innebygd i Notion og er designet for at hvem som helst skal kunne sette dem opp. Workers er for utviklere som ønsker å kjøre tilpasset kode. Hvis du ikke trenger kode, bør du starte med automaseringer.
Kjører Workers på mine servere?
Kjører Workers på mine servere?
Nei. Workers kjører på Notions servere, så du trenger ikke å sette opp eller administrere noen infrastruktur.
Trenger jeg CLI for å bruke Workers?
Trenger jeg CLI for å bruke Workers?
Ikke alltid. Du kan se Workers, lese logger, slå av Workers og slette Workers i Notion med utviklermodus. Du trenger vanligvis CLI eller teamets kodingsverktøy for å sette opp, distribuere eller endre en Worker.
