Skip to main content
PATCH
TypeScript SDK
Links a full-page meeting note to a calendar event and returns the meeting note in meeting_note as a meeting notes block. The link replaces any event the meeting note is already linked to. The REST API has no calendar endpoint yet. To find an event’s IDs, use notion-calendar-list-events in Notion MCP. Pass its calendar.accountId, calendar.calendarId, and eventId as calendar.account_id, calendar.calendar_id, and event_id. By default, this endpoint doesn’t link a meeting note to an event that already has other meeting notes. It returns a 409 with their IDs in additional_data.other_meeting_note_ids. Pass allow_other_meeting_notes: true to link anyway. On success, other_meeting_note_ids lists the other meeting notes you can read that are linked to the same event. For a meeting note inside a page, the ID is the page’s. Notion checks at most 50 meeting notes, so the list may be incomplete.

Workers

A Notion Worker calling this endpoint needs a connected calendar, and the event’s calendar must be one the Worker can read. The Worker acts as itself, so the meeting note must be shared with it. If this endpoint returns a 409, delete the meeting note the Worker created or pass allow_other_meeting_notes: true.

Requirements

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

Errors

Returns a 400 HTTP response if the block isn’t a full-page meeting note, or 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, if the user can’t edit the meeting note, or if a Worker can’t read the event’s calendar. Returns a 404 HTTP response if the meeting note doesn’t exist or the integration can’t access it. Returns a 409 HTTP response if the event has other meeting notes and allow_other_meeting_notes isn’t true. 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

Path Parameters

meeting_note_id
string
required

ID of the full-page meeting note.

Body

application/json
calendar_event
object
required

Calendar event to link the meeting note to. Replaces any event it is already linked to.

allow_other_meeting_notes
boolean

Link even when other meeting notes are linked to the same event. Defaults to false, which returns a 409 listing them instead.

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.

other_meeting_note_ids
string<uuid>[]
required

IDs of other meeting notes you can read that are linked to the same event. For a meeting note inside a page, this is the page's ID. Only the first 50 meeting notes found are checked.

Maximum array length: 50