LogoNotion AI Hub Docs
LogoNotion AI Hub Docs
Homepage
Notion AI 基础
Custom Agent
Create Your First AgentInstruction Writing GuideDebugging & OptimizationKnowledge BaseTriggersModel SelectionRouting PatternCreditsKnown Limitations
Workers
Automation
最佳实践
X (Twitter)
Custom Agent

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

Credits consumption statistics

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

MiniMax 2.5 low-cost model

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.

More models coming soon

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.

Table of Contents

Credits
Billing System
Real-World Usage Cost Reference
Factors Affecting Credits Consumption
Tips for Saving Credits
Future Outlook