Buy & track Notion credits for Custom Agents

Notion credits are a recurring add-on available on Business and Enterprise plans. Custom Agents use Notion credits each time they perform a task. In general, more complex tasks use more credits.

If you manage your billing in-product, admins can purchase and monitor credit usage from the Notion credits dashboard. Monthly Notion credits cost $10 per 1,000 credits, are billed alongside your subscription, and are flexible to adjust each month based on your needs. They’re shared across the workspace and reset monthly.

If you have an account team, they can help you plan your credit needs and explore additional credit options.

Custom Agents begin using credits on May 4, 2026.

If your workspace doesn’t have enough credits, Custom Agents will pause automatically until an admin adds more. Learn when you can purchase credits below.

If you already have Custom Agents running from the beta:

• Your workspace gets promotional credits, so your agents don’t automatically pause on May 4, 2026. This gives you time to purchase credits.

When you purchase credits:

• Your credit billing aligns to your monthly service date (not the date you purchase credits). Your monthly service date is tied to when your Notion subscription started.

  • For example, if your monthly service date is May 9, your credit billing starts on May 9.

• You can find your monthly service date in the Notion credits dashboard.

Admins can purchase Notion credits starting with the first monthly service date on or after May 4, 2026.

• Purchase in-product: Buy what you need starting in the hundreds and scaling into the thousands in the Notion credits dashboard.

• Purchase through an account team: Your account team can help you plan and explore additional credit options.

To purchase credits in the Notion credits dashboard:

• Go to Settings → Access & billing → Notion credits.

• Select Add Notion credits.

• Choose an amount.

You can set how much you want to buy starting in hundreds and scaling into the thousands.

Here’s what to know before you buy Notion credits:

• Get the full credit amount right away: When you purchase monthly credits, the full amount is available in your workspace right away, regardless of where you are in your billing cycle. Credits are not prorated.

• Credits reset monthly: On your add-on service date, your credits refill to the amount you purchased. Any unused credits don’t carry over to the next month.

• Credits are shared across the workspace: Credits are pooled at the workspace level. Any Custom Agents in the workspace draw from the same balance, regardless of who created or ran it.

• Adjust credits month to month: Admins can adjust the purchased amount up or down each billing cycle to match actual usage.

• Credits are billed with your subscription: Notion credits are billed with your Business or Enterprise plan.

• You can purchase anytime: If you run out of credits before your monthly service date, you can purchase more mid-cycle to keep agents running without interruption.

Custom Agents use credits based on the work needed to complete a run. In general, agents use more credits when they read more content, take more actions, or run more often.

The amount of Notion credits used depends on these key factors:

• How much the agent reads: Reading longer pages, searching more content, or scanning larger databases generally uses more credits.

• How many steps it takes: More tool calls and multi-step workflows use more credits.

• How often it runs: Agents that run on a schedule or are triggered frequently will use more credits over time.

• Model choice: Advanced models use more credits because they handle more complex reasoning. For most cases, we recommend Auto, which lets Notion match to a model based on the task.

After each run, admins and agent creators can see exact usage in the Notion credits dashboard.

Here’s an example showing two Custom Agents with similar goals using different amounts of Notion credits. Even if two Custom Agents run the same number of times per month, the one that takes more complex steps per run will use more Notion credits:

Credit usage varies depending on what your Custom Agent does. The examples below are based on popular use cases. However, actual usage will depend on factors like how often your agent runs, how many steps it takes, and what model it uses.

Use the table below as a starting point to estimate costs:

• Find the closest use case.

• Multiply “costs per run” by how many runs you expect per month.

• For example, if your agent is like a “Status update agent,” and runs 60 times per month, that’s about $4.80–$10.80 per month.

The Notion credits dashboard gives a clear view of how Custom Agents use Notion credits across the workspace. Use it to track usage, plan future credit needs, and manage ongoing spend.

To access the Notion credits dashboard, go to Settings → Access & billing → Notion credits.

Admins on Business and Enterprise plans can monitor agent usage in the dashboard. Agent creators can also see workspace-level credit pacing, and the agent table will show only the Custom Agents they’ve created.

In the dashboard, you can monitor:

• Credit usage in real time.

• Estimated usage through your monthly service date.

• Agent-level runs and credit usage to identify the agents driving spend so you can adjust them as needed.

If you manage multiple workspaces, you’ll have a Notion credits dashboard in your admin console where you can track credit pacing and Custom Agent usage across your organization.

• At the top of the dashboard, you’ll see the total Notion credits used for the selected period and your credits-reset date. The selected period is based on your workspace’s billing cycle.

• This gives you a quick snapshot of your usage so far and when your monthly billing cycle ends.

In the top-right corner, use the period selector (for example, Current period) and navigation arrows to review past periods.

The usage chart shows credit usage over time:

• Current shows your actual credits used so far.

• Estimated projects where your usage is likely to land by the reset date if current patterns continue. The estimate is provided for informational purposes only and actual future usage may differ.

Use this to spot whether you’re pacing toward running out of credits before the reset.

Under This month’s usage, you’ll see adoption and activity metrics such as:

• Agent builders: How many members are creating Custom Agents.

• Agents in action: How many live Custom Agents are running during the period.

• Runs completed: How many tasks agents have completed across your workspace.

Below the summary section, you’ll see a table breaking down usage by agent. This typically includes:

• Notion credits used

• Runs completed

• Status

• Created by

Admins can monitor credit usage and control how Custom Agents run so spend stays predictable.

Admins have several ways to manage credit pacing:

• Visibility: Track usage and trends in the Notion credits dashboard.

• Guardrails: Decide who can create agents (and set limits).

• Control: Pause or switch off agents anytime to stop usage while you investigate or make changes.

• Optimize: Fine-tune agents to reduce extra steps and improve efficiency.

Use the Notion credits dashboard to track usage over time and see which agents are using the most credits. Notion also notifies admins when the workspace is approaching or has reached the credit limit, so admins have time to act.

Set credit limits from individual agents so they pause when they hit a threshold.

Control who can create agents (everyone, workspace owners only, or selected members).

Pause or switch off a Custom Agent anytime to immediately stop credit usage while you review activity or adjust the agent.

View agent-level insights to understand total runs and performance across your workspace. Identify high-usage agents, then tune them to reduce unnecessary runs or extra steps.