Credits
Understand the Credits billing system for Notion Custom Agent, real-world usage costs, and tips for saving Credits.
Credits
Custom Agent uses a Credits-based billing system.
Billing System
- Tentative pricing: 1000 Credits / $10
- Currently in beta, Credits fees are waived
- Official billing begins after May 4, 2026
- BYOK (Bring Your Own Key) is not currently supported — you cannot use your own API Key
Real-World Usage Cost Reference
- Heavy users (over a dozen Agents running continuously + extensive testing): approximately 50,000 Credits/month
- Normal usage (excluding test cases): approximately 30,000 Credits/month, roughly $300
- For comparison, $300 could cover subscriptions to both ChatGPT Pro and Claude Max 5X

Factors Affecting Credits Consumption
- Model selection: higher-end models consume more Credits; lower-end models are cheaper
- Trigger frequency: scheduled triggers are more controllable than event-based triggers
- Instruction complexity: the more context read and the more complex the steps, the higher the consumption
- Number of Agents: each Agent consumes Credits every time it is triggered
Tips for Saving Credits
- Use low-cost models like MiniMax 2.5 for simple tasks (Credits consumption can be reduced by roughly two-thirds)
- Pre-filter with email labels to prevent irrelevant emails from triggering Agents (labels are applied by Notion AI for free and do not consume Custom Agent Credits)
- Use the routing pattern with a single entry Agent to distribute work, avoiding multiple Agents being triggered simultaneously
- Split instructions into sub-pages loaded on demand to reduce context per execution
- Regularly evaluate whether each Agent is necessary and remove those that are not essential

Future Outlook
The Notion CEO has stated that more models will be added. As more low-cost models become available, Credits pressure is expected to ease.

Last updated on
Routing Pattern
Learn how to manage multiple Notion Custom Agents using the routing pattern — reduce unnecessary credit consumption through entry-point routing and email label pre-filtering.
Known Limitations
Understand the current known limitations of Notion Custom Agent, including Worker capability boundaries, permission stability issues, and Notion ecosystem lock-in.
Notion AI Hub Docs