Notion
Notion API
| Type | Endpoint | Returns |
|---|---|---|
| /v1/users/me | Retrieve your token's bot user | |
| /v1/users/{user_id} | Retrieve a user | |
| /v1/users | List all users | |
| /v1/pages/{page_id} | Retrieve a page | |
| /v1/pages/{page_id}/properties/{property_id} | Retrieve a page property item | |
| /v1/pages/{page_id}/markdown | Retrieve a page as markdown | |
| /v1/async_tasks/{task_id} | Retrieve an async task | |
| /v1/blocks/{block_id} | Retrieve a block | |
| /v1/blocks/{block_id}/children | Retrieve block children | |
| /v1/data_sources/{data_source_id} | Retrieve a data source | |
| /v1/data_sources/{data_source_id}/templates | List templates in a data source | |
| /v1/databases/{database_id} | Retrieve a database | |
| /v1/comments | List comments | |
| /v1/comments/{comment_id} | Retrieve a comment | |
| /v1/file_uploads | List file uploads | |
| /v1/file_uploads/{file_upload_id} | Retrieve a file upload | |
| /v1/custom_emojis | List custom emojis | |
| /v1/views | List views | |
| /v1/views/{view_id} | Retrieve a view | |
| /v1/views/{view_id}/queries/{query_id} | Get view query results | |
| /v1/agents/{agent_id} | Get agent | |
| /v1/agents/{agent_id}/insights | Get agent insights | |
| /v1/ai/plugins | List skills plugins | |
| /v1/ai/plugins/{id} | Get a plugin directory | |
| /v1/ai/skills/{id} | Get a skill directory | |
| /v1/sessions/{session_id} | Retrieve a session | |
| /v1/pages | Create a page | |
| /v1/pages/{page_id} | Update page | |
| /v1/pages/{page_id}/move | Move a page | |
| /v1/pages/{page_id}/markdown | Update a page's content as markdown | |
| /v1/blocks/{block_id} | Update a block | |
| /v1/blocks/{block_id} | Delete a block | |
| /v1/blocks/{block_id}/children | Append block children | |
| /v1/data_sources/{data_source_id} | Update a data source | |
| /v1/data_sources/{data_source_id}/query | Query a data source | |
| /v1/data_sources | Create a data source | |
| /v1/databases/{database_id} | Update a database | |
| /v1/databases | Create a database | |
| /v1/search | Search by title | |
| /v1/comments | Create a comment | |
| /v1/comments/{comment_id} | Update a comment | |
| /v1/comments/{comment_id} | Delete a comment | |
| /v1/file_uploads | Create a file upload | |
| /v1/file_uploads/{file_upload_id}/send | Upload a file | |
| /v1/file_uploads/{file_upload_id}/complete | Complete a multi-part file upload | |
| /v1/views | Create a view | |
| /v1/views/{view_id} | Update a view | |
| /v1/views/{view_id} | Delete a view | |
| /v1/views/{view_id}/queries | Create a view query | |
| /v1/views/{view_id}/queries/{query_id} | Delete a view query | |
| /v1/blocks/meeting_notes | Create a meeting note | |
| /v1/blocks/meeting_notes/query | Query meeting notes | |
| /v1/agents/query | Query agents | |
| /v1/agents/{agent_id} | Delete agent | |
| /v1/agents/{agent_id}/status | Update agent status | |
| /v1/agents/{agent_id}/credit_limit | Update agent credit limit | |
| /v1/agents/batch | Apply many agent operations | |
| /v1/sessions | Update a session | |
| /v1/sessions/query | Query sessions | |
| /v1/sessions/{session_id}/events/query | Query session events | |
| /v1/sessions/{session_id}/cancel | Cancel a session | |
| /v1/oauth/token | Exchange an authorization code for an access and refresh token | |
| /v1/oauth/revoke | Revoke a token | |
| /v1/oauth/introspect | Introspect a token |
Working with it through the API
| Question | Rating | Why |
|---|---|---|
| Can an assistant read everything? | 15 list endpoints (15 with paging) among 26 read operations and 64 in all.Source | |
| Does it tell us when something changes? | Webhooks exist (31 events), signed.Source | |
| Is there an official library? | Official JavaScript (@notionhq/client), TypeScript (@notionhq/workers).Source | |
| Is there an MCP server? | The vendor runs an MCP server at https://mcp.notion.com/mcp.Source | |
| How easy is it to sign in? | A static credential the owner makes in the tool: no consent screen.Source |
MCP server
Checked on 2026-10-07 in the developer documentation.
How to use Notion
If you've decided to use Notion for your B2B marketing needs, here's a step-by-step guide on how to set up and get the most out of the tool.
Read the full guideShow less
Setting up your Notion workspace
- Create a workspace: First, sign up for Notion and create your workspace. Once you're in, you can start by building a dashboard that includes links to all the important areas of your work, such as campaigns, content, tasks, and knowledge management. You can start with a template, or create one from scratch.
- Set up pages for different projects: In Notion, everything is organised into pages. Create pages for each of your major projects, such as a marketing campaign, content strategy, or client management. Within each page, you can add subpages, tasks, and other details relevant to that project. This keeps everything organised and easy to access.
- Create databases: Databases in Notion are powerful. You can use them to track tasks, manage content calendars, or even store customer information. Create a database for each part of your process for example, a "Campaign Tracker" database to track the progress of each campaign, including start dates, deadlines, and status updates. You can use different views such as a table, board (Kanban), or calendar depending on how you want to visualise your data.
- Build your task management system: Notion allows you to create detailed task lists, including assignees, due dates, and priority levels. You can set up tasks for each team member, link them to specific campaigns, and track their progress. Using tags or categories makes it easy to filter tasks based on priority or completion status.
- Collaborate with your team: Notion excels at collaboration. You can invite team members to your workspace, assign tasks, and share documents in real-time. If you're working on a marketing campaign, for example, you can all contribute ideas, track progress, and leave comments within the same page.
- Use templates for efficiency: Notion has a library of templates to help you get started quickly. You can use templates for meeting notes, project management, content planning, and more. Customise these templates to suit your needs and save time on setting up your workspace.
Managing your content calendar
- Create a content calendar: For B2B marketers, keeping track of content is crucial. In Notion, you can create a content calendar using a database view with dates and categories for each piece of content. This will help you plan blog posts, social media content, webinars, and more in a clear and organised way.
- Add task details: Each content item in the calendar can be linked to a task list where team members can track progress and deadlines. You can also link content ideas, assign tasks, and track the content creation process in one place.
Monitoring team progress and performance
- Set up dashboards: Notion lets you create custom dashboards where you can bring together various pages and databases. Create a dashboard to track overall marketing performance, project timelines, and team progress. Link it to your task management system, content calendar, and campaign tracker for an at-a-glance view of your team's work.
- Review analytics: While Notion itself isn't built for advanced analytics, it's an excellent place to store and review project data. You can integrate Notion with other tools, such as Google Analytics or your CRM, to pull in relevant data and store it in your workspace.
Conclusion
Notion is an incredibly powerful tool for B2B marketers looking to centralise project and task management. Its flexibility, customisation options, and collaborative features make it ideal for managing everything from marketing campaigns to content creation. While it's great for smaller teams, larger operations may face some limitations as the need for automation and advanced reporting increases. However, if you're looking for an all-in-one workspace that's highly adaptable to your workflow, Notion is my go-to tool for managing everything in one place.
How to automate Notion
Native integrations
Notion connects to the apps around it, such as Slack, GitHub and Google Drive, and the Business plan adds premium connections. A useful first step is to connect Slack so that a thread can become a task in a database without copy and paste.
API and webhooks
Notion has a public REST API with documentation for databases, pages and content. Use it to create database rows from your own systems. A form submission or a new HubSpot deal could become a task row in the delivery database.
MCP server
Notion runs an official hosted MCP server that uses OAuth. A client such as Claude, Cursor or Codex can search, read, create and update pages and databases that you have access to. Workspace owners control which clients may connect from the Connections settings. A good use is asking an agent for a weekly summary of what changed in a project database.
Built-in automation
Notion AI agents can take on repeat work inside the workspace, for example triaging feedback or compiling a weekly report. These are on the Business plan and above, and usage beyond the trial is metered.