Skip to main content
POST
TypeScript SDK
Creates a full-page meeting note and returns it in meeting_note as a meeting notes block with is_full_page set to true. To create AI meeting notes from an uploaded recording instead, use Create a meeting note. markdown sets the content of the meeting note’s Notes tab. You can’t pass parent, title, or markdown with calendar_event. The API can’t add content to the meeting note after this call. To find an event’s IDs for calendar_event, see Link a full-page meeting note to a calendar event. The response’s created field is true when Notion created a new meeting note and false when it returned an existing one. Without calendar_event, every call creates a new meeting note. When an event has a meeting note that the user can’t read, Notion creates a new one. The event then has two meeting notes. With calendar_event, the existing meeting note can be a meeting notes block inside a page, with is_full_page set to false.

Workers

A Notion Worker calling this endpoint needs a connected calendar. It acts as itself: the parent must be shared with the Worker, and the Worker is recorded as the meeting note’s creator. A Worker must pass parent and can’t pass calendar_event. To link its meeting note to an event, call Link a full-page meeting note to a calendar event next.

Requirements

This endpoint accepts personal access tokens and Workers. The integration must have the Read content and Insert content capabilities. See the capabilities guide.

Errors

Returns a 400 HTTP response if the request combines calendar_event with parent, title, or markdown, or if a Worker passes calendar_event or omits parent. Also returns a 400 if a Worker has no working calendar connection. Returns a 403 HTTP response if the token isn’t a personal access token or a Worker, or if the user can’t edit the parent. Returns a 404 HTTP response if the parent doesn’t exist or the integration can’t access it. Each Public API endpoint can return several possible error codes. See the Error codes section for more information.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Notion-Version
enum<string>
required

The API version to use for this request. The latest version is 2026-03-11.

Available options:
2026-03-11

Body

application/json
parent
object

Page or data source to create the meeting note in. Defaults to the user's meeting notes database, which is created if they don't have one. Not accepted with calendar_event.

title
string

Title for the meeting note. Not accepted with calendar_event.

Maximum string length: 2000
markdown
string

Content for the meeting note's Notes tab, as Markdown. Not accepted with calendar_event.

calendar_event
object

Calendar event to get or create the meeting note for. The meeting note is filed and titled like the event's other meeting notes. Add content to it afterwards.

markdown_version
enum<string>

The Markdown syntax to use. v2 is Notion-flavored Markdown and is recommended. v1 is enhanced markdown. It's deprecated. It's the default on current Notion-Versions. The next Notion-Version rejects v1 with a 400 validation_error.

Available options:
v1,
v2

Response

object
string
required

Always "meeting_note_page_result".

Allowed value: "meeting_note_page_result"
meeting_note
object
required

The full-page meeting note, as a meeting_notes block.

created
boolean
required

Whether the meeting note was created, rather than an existing meeting note for the event returned.