Notion’s New API (09-03-2025): Tiny Swap for Query and Create + My 3 Notion Shortcuts

Hola, mi gente! I’m Jen (aka Biz Strtga). If you use my Notion + Apple Shortcuts to capture tasks on your phone, this update is for you! Notion just changed how the API talks to databases; now you’ll point to a data source (the table inside your database).

No panic, no rebuild. In a couple of minutes you’ll:

• swap the query URL to the new data-source route,

• keep /v1/pages for creates but set the parent to your Data Source ID, and

• install my 3 updated Notion shortcuts for iOS (one-tap ready).

Prefer to skip the steps? I’ve got 3 Notion Shortcuts for iOS and macOS with short  video tutorials + all two new Apple shorcuts that pull Overdue Tasks + My Day Agenda from Notion!

TL;DR – Two quick cases

A) If your Shortcut queries data (lists, searches, lookups)

Old (legacy): POST /v1/databases/{DATABASE_ID}/query
New: POST /v1/data_sources/{DATA_SOURCE_ID}/query

Headers (unchanged shape):

Your request JSON body (filters/sorts/page_size) stays the same; only the URL (and the ID you target) changes.

B) If your Shortcut creates a task/page (Quick-Add flow)

Endpoint stays: POST /v1/pages
You just change the parent object to use the data source.

Before

After (new)

Headers:

Step 1 — Secret key (same as before)

Create/confirm your Internal Integration Token in My Integrations. You’ll use it as the Bearer token. Don’t share it.

Step 2 — Permissions (important)

Open your database as a full page → Connections → Add connections → select your integration.

If the integration can’t “see” the database/data source, calls will fail (404/403).

Step 3 — Find your Data Source ID (new)

Open your database as a full page → Database settings → Manage Data Sources → (⋯) → Copy data source ID.

Tip: If you have multiple data sources, pick the one your Shortcut targets (avoid linked views; use the source database page).

Use my short video to copy the ID from the Data Sources panel:

Step 4 — Update your Shortcut

If you query

1. Replace the URL with:

https://api.notion.com/v1/data_sources/<DATA_SOURCE_ID>/query

2. Keep your body filters/sorts.

3. Confirm headers (see above).

If you create a task

1. Keep URL: https://api.notion.com/v1/pages

2. Update parent → data_source_id (see snippet).

3. Keep your property payload as-is (just make sure names/types match your schema).

4. Confirm headers.

Minimal create example (Name only)

Rather skip the build? Install my 3 Notion Shortcuts

• Quick-Add Notion Task (Updated)
• View Your Day Agenda
• View Overdue Notion Tasks

Troubleshooting (quick checks)

• 404/403: Share the database container + data source with your integration.

• “Unknown endpoint”: For queries, use /v1/data_sources/{id}/query (not /databases/.../query).

• Create fails: You likely kept database_id. Switch to data_source_id in parent.

• Header mismatch: Set Notion-Version: 2025-09-03.

• Rate limit (429): Back off and retry; most Shortcuts only make 1–2 calls.

Preflight Checklist

• Share the database with your integration (••• → Add connections).

• Querying? Use POST /v1/data_sources/{DATA_SOURCE_ID}/query.

• Creating? Keep POST /v1/pages, but parent = data_source_id.

• Headers set:

  • Authorization: Bearer <YOUR_NOTION_SECRET>
    
    
    • There's a space between Bearer and Your Key!
  • Content-Type: application/json
    
    
  • Notion-Version: 2025-09-03

• Using a linked database view? Target the source database!

FAQ

Do I need to rebuild everything?
No. For queries, swap the URL. For creates, keep /v1/pages and switch the parent to data_source_id.

Where do I find the Data Source ID?
Open your database as a full page → Database settings → Manage Data Sources → (⋯) → Copy data source ID.

Can I still use property names in my body?
Yes; your filters/sorts/properties JSON code works the same.

Does this work on iPhone/iPad?
Yep. Mac can make initial setup easier, but it’s not required.

Security reminder:
Treat your integration token like a password. Don’t share it or show it in screenshots.

Want the full build from scratch?

If you’re new to Apple Shortcuts, start with my original step-by-step tutorial, then hop back here for the tiny API swap.

→ How I create Notion tasks with due dates via Apple Shortcuts | Video & Step-by-Step Tutorial (This post links back here for the update.)

Final notes ✨

This update is small but future-proofs your automations. Do the quick swap for queries or the tiny parent tweak for creates, and keep shipping. If you want the fast route, grab the Notion Shortcuts pack with the video tutorials!