Connecting Your Notion Database to airsource

This guide takes about 2 minutes. You will create a Notion Integration, share it with your Database, then enter the credentials in airsource.

Step 1: Create a Notion Integration

  1. Go to https://www.notion.so/profile/integrations
  2. Click + New integration
  3. Enter a name, e.g. airsource Sync
  4. Select the workspace that contains your database
  5. Click Save
  6. Copy the Internal Integration Secret — it starts with secret_

Step 2: Share Your Database with the Integration

This is the most commonly missed step.

  1. Open the Notion database you want to sync data into
  2. Click the ... (More) menu in the top-right corner
  3. Click Connections
  4. Find your Integration (e.g. airsource Sync) and click Connect

Without this step, airsource cannot access the database even with a valid token.

Step 3: Get Your Database ID

The Database ID is in the URL when you open the database page:

https://www.notion.so/your-workspace/DATABASE_ID?v=...

The ID is the 32-character segment (with or without hyphens). Example:

12345678-1234-1234-1234-123456789abc

Step 4: Enter Credentials in airsource

During onboarding, select Notion as your destination and enter:

  • Integration Token: the secret_... value from Step 1
  • Database ID: the UUID from Step 3

airsource will test the connection automatically. If the test fails, check that the Integration is shared with the Database (Step 2).

Notes

  • airsource writes data to a stripe_id column to track records. Add a Text property named stripe_id to your database for best results.
  • Each Stripe event will be synced as a row in your database.
  • The Integration only needs Read content, Update content, and Insert content capabilities.

Ready to connect?

Create your integration in 5 minutes.

Join the waitlist