Integration Credits: what your API requests and webhooks run on

What a request costs

Most of what an integration does costs nothing. Credits are for reading in bulk, and for adding new things.

• Reading one thingFreeOne day, a table, a list, your journal, or your account.
• Changing what is already thereFreeCompleting, editing or reopening tasks, setting deadlines, pinning tables, changing a table's settings.
• Deleting, and managing webhooksFreeDeleting one thing at a time, and setting up or removing webhooks and links.
• Reading many things, or searching1 credit a requestSeveral days or totals, and searches. A long range comes a page at a time, each page one request.
• Downloading a file1 credit a requestAn image, a recording or a doc.
• Adding something new1 credit a requestA table, tasks, a comment, notes or a journal line. Also copying or moving a table, and rewriting a journal line.
• Tasks and tables in bulk1 credit per 25 tasks25 tasks added count as 1 credit, a new table's first 25 included. Making many tables at once is 1 credit for every 10.

The full price list, on the API page

Webhooks

Included in your plan, every week

Weekly credits renew every Monday at 00:00 UTC and are used before any you bought. Need more? Buy them on the Subscription page at $0.01 each, from 500 credits ($5). Bought credits never expire.

Sharing with your team

A Team plan's owner can let the people who can edit their tables use the plan's Integration Credits, with a switch on the Subscription page. It is off until you turn it on.

• Someone using your credits needs no plan of their own. With a plan, their requests use their own credits.
• People who can only view your tables never use them.

If you run out

A request that costs credits answers 402 insufficient_credits. Free requests keep working, your weekly credits renew on Monday (UTC), and you can buy more on the Subscription page.

Where you see your usage

The AI Usage page has an Integration Credits view: every API request that used credits, and webhook events in batches, newest first.

• Each row says what the request did.
• A Team plan's owner also sees what the team used, by name.
• My Profile and the Subscription page show this week's credits, the ones you bought, and the total. Your code can ask too: GET /v1/me answers with the credits left.

Questions