Workspace and knowledge management API for searching, creating, and updating pages, databases, and blocks in Notion. Best for workflows that need to read or write structured content — project boards, wikis, meeting notes, and knowledge bases. Unlike Google Workspace (document-centric), Notion’s API exposes a database-like structure where pages have typed properties.
6 example endpoints available through Lava’s AI Gateway. See the Notion API docs for full documentation.
This provider requires your own credentials — connect your API key or OAuth account before use.
Endpoints Search pages and databases POST https://api.notion.com/v1/search — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/search' , { body: { "query" : "your search term" } });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fsearch" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"query":"your search term"}'
Query a database POST https://api.notion.com/v1/databases/{database_id}/query — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/databases/{database_id}/query' , { body: {} });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fdatabases%2F%7Bdatabase_id%7D%2Fquery" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{}'
Retrieve a page GET https://api.notion.com/v1/pages/{page_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages/{page_id}' , { method: 'GET' });
curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages%2F%7Bpage_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY "
Create a page POST https://api.notion.com/v1/pages — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages' , { body: { "parent" : { "database_id" : "..." }, "properties" : { "Name" : { "title" : [ { "text" : { "content" : "New page" } } ] } } }, });
curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"parent":{"database_id":"..."},"properties":{"Name":{"title":[{"text":{"content":"New page"}}]}}}'
Update page properties PATCH https://api.notion.com/v1/pages/{page_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/pages/{page_id}' , { method: 'PATCH' , body: { "properties" : { "Status" : { "select" : { "name" : "Done" }}}} });
curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fpages%2F%7Bpage_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json" \ -d '{"properties":{"Status":{"select":{"name":"Done"}}}}'
Delete a block DELETE https://api.notion.com/v1/blocks/{block_id} — Freeconst data = await lava . gateway ( 'https://api.notion.com/v1/blocks/{block_id}' , { method: 'DELETE' });
curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Fapi.notion.com%2Fv1%2Fblocks%2F%7Bblock_id%7D" \ -H "Authorization: Bearer $LAVA_SECRET_KEY " \ -H "Content-Type: application/json"
Next Steps
All Providers Browse all supported AI providers
Forward Proxy Learn how to construct proxy URLs and authenticate requests
