Skip to content

Notion: Create a meeting note

Notion meetingNotes.createMeetingNote: arguments, response, policy and SDK examples.

← Meeting notes operations · Get started

Operation notion.create_meeting_note

Provider route: POST /v1/blocks/meeting_notes. Alter supplies the connection’s credentials and routing.

Install @alter-ai/sdk @alter-ai/notion with npm, or alter-sdk-notion with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { NotionIntegration } from "@alter-ai/notion";
async function execute(input: Parameters<NotionIntegration["meetingNotes"]["createMeetingNote"]>[0]) {
const app = new App({ apiKey: process.env.ALTER_API_KEY! });
try {
const provider = new NotionIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
const call = await provider.meetingNotes.createMeetingNote(input);
const result = await call.wait();
return result.bodyJson();
} finally {
await app.close();
}
}
import os
from alter_sdk import App
from alter_sdk_notion import NotionIntegration
async def execute(arguments):
async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
provider = NotionIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
call = await provider.meeting_notes.create_meeting_note(arguments)
result = await call.wait()
return result.body_json()
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: not allowed
bodyJSONRequired within parent
body (allOf 1)objectAll variants apply
body (allOf 1).languagestringOptionalLanguage hint for transcription. Defaults to automatic detection.
One of: auto, en, zh-CN, zh-TW, es, fr, de, ja, ko, pt, ru, th, vi, id, da, fi, no, nl, it, sv, ar, he, pl
body (allOf 1).optionsobjectOptionalOptional processing settings.
Additional keys: not allowed
body (allOf 1).options.kickoff_summarybooleanOptionalWhether to start summary generation after transcription.
body (allOf 1).titlestringOptionalTitle for the meeting note.
Maximum length: 2000
body (allOf 2)JSONAll variants apply
body (allOf 2) (oneOf 1)objectAlternative
body (allOf 2) (oneOf 1).parentobjectRequired within parentParent page for the new meeting note.
Additional keys: not allowed
body (allOf 2) (oneOf 1).parent.page_idstringRequired within parentPage ID where the meeting note should be created. Required for file_upload sources.
body (allOf 2) (oneOf 1).parent.typestringRequired within parentAlways “page_id”.
Must equal: page_id
body (allOf 2) (oneOf 1).sourceobjectRequired within parentAudio or video source for the meeting note.
Additional keys: not allowed
body (allOf 2) (oneOf 1).source.file_upload_idstringRequired within parentID of a completed public API file upload.
body (allOf 2) (oneOf 1).source.typestringRequired within parentAlways “file_upload”.
Must equal: file_upload
body (allOf 2) (oneOf 2)objectAlternative
body (allOf 2) (oneOf 2).parentJSONOptionalNot accepted for block sources.
Disallowed: {}
body (allOf 2) (oneOf 2).sourceobjectRequired within parentAudio or video source for the meeting note.
Additional keys: not allowed
body (allOf 2) (oneOf 2).source.block_idstringRequired within parentID of an existing audio, video, or file block.
body (allOf 2) (oneOf 2).source.typestringRequired within parentAlways “block”.
Must equal: block

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

FieldTypePresenceDescription and constraints
$JSONRoot
$ (anyOf 1)objectAlternativeAdditional keys: allowed
$ (anyOf 1).idstringRequired within parentThe ID of the meeting note block.
Format: uuid
$ (anyOf 1).objectstringRequired within parentAlways “block”.
Must equal: block
$ (anyOf 2)ModelAlternativeExpand Create a meeting note — response body — object block, type meeting notes

Referenced models: Create a meeting note — response body — object block, type meeting notes

11 more schemas are linked from the tables above, on the schema pages.

Create a meeting note — response body — object block, type meeting notes
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
created_byModelRequired within parentExpand Update page — response body — object page created by
User who created this meeting note.
created_timestringRequired within parentISO-8601 timestamp when this meeting note was created.
has_childrenbooleanRequired within parentWhether this block has child blocks.
idstringRequired within parentThe ID of the meeting note block.
Format: uuid
in_trashbooleanRequired within parentWhether this meeting note is in the trash.
last_edited_byModelRequired within parentExpand Update page — response body — object page created by
User who last edited this meeting note.
last_edited_timestringRequired within parentISO-8601 timestamp when this meeting note was last edited.
meeting_notesModelRequired within parentExpand Create a meeting note — response body — object block, type meeting notes meeting notes
objectstringRequired within parentAlways "block".
Must equal: block
typestringRequired within parentAlways "meeting_notes".
Must equal: meeting_notes

Referenced models: Update page — response body — object page created by, Create a meeting note — response body — object block, type meeting notes meeting notes

Update page — response body — object page created by
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
idstringRequired within parentFormat: uuid
objectstringRequired within parentAlways `user`
Must equal: user
Create a meeting note — response body — object block, type meeting notes meeting notes
FieldTypePresenceDescription and constraints
$objectRootMeeting note content fields.
Additional keys: allowed
calendar_eventModelOptionalExpand Create a meeting note — response body — object block, type meeting notes meeting notes calendar event
childrenobjectOptionalBlock IDs for each tab (summary, notes, transcript).
Additional keys: allowed
children.notes_block_idstringOptionalBlock ID of the meeting notes tab.
Format: uuid
children.summary_block_idstringOptionalBlock ID of the AI summary tab.
Format: uuid
children.transcript_block_idstringOptionalBlock ID of the transcript tab.
Format: uuid
is_full_pagebooleanRequired within parentWhether this is a full-page meeting note.
recordingobjectOptionalStart and end times of the actual recording.
Additional keys: allowed
recording.end_timestringOptionalISO-8601 timestamp when the recording ended.
recording.start_timestringOptionalISO-8601 timestamp when the recording started.
statusstringOptionalCurrent processing status of the meeting note transcription.
Known values: transcription_not_started, transcription_paused, transcription_in_progress, transcription_failed, summary_in_progress, notes_ready
titlearrayOptionalTitle of the meeting note as rich text.
Maximum items: 100
title[]ModelEach itemExpand Retrieve a page property item — response body — value Title title

Referenced models: Retrieve a page property item — response body — value Title title, Create a meeting note — response body — object block, type meeting notes meeting notes calendar event

Retrieve a page property item — response body — value Title title
FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Retrieve a page property item — response body — value Title title annotations, href, plain text
$ (allOf 2)JSONAll variants apply
$ (allOf 2) (anyOf 1)ModelAlternativeExpand Retrieve a page property item — response body — value Title title value Text
$ (allOf 2) (anyOf 2)ModelAlternativeExpand Retrieve a page property item — response body — value Title title value Mention
$ (allOf 2) (anyOf 3)ModelAlternativeExpand Retrieve a page property item — response body — value Title title value Equation

Referenced models: Retrieve a page property item — response body — value Title title value Equation, Retrieve a page property item — response body — value Title title value Mention, Retrieve a page property item — response body — value Title title annotations, href, plain text, Retrieve a page property item — response body — value Title title value Text

Create a meeting note — response body — object block, type meeting notes meeting notes calendar event
FieldTypePresenceDescription and constraints
$objectRootCalendar event metadata associated with this meeting note.
Additional keys: allowed
attendeesarrayOptionalList of attendee user IDs.
Maximum items: 100
attendees[]stringEach itemFormat: uuid
end_timestringRequired within parentISO-8601 end time of the calendar event.
event_idstringOptionalID of the calendar event, as returned by the calendar tools.
start_timestringRequired within parentISO-8601 start time of the calendar event.
Retrieve a page property item — response body — value Title title value Equation
FieldTypePresenceDescription and constraints
$objectRoot
equationobjectRequired within parentNotion supports inline LaTeX equations as rich text objects with a type value of `equation`.
Additional keys: allowed
equation.expressionstringRequired within parentA KaTeX compatible string.
typestringRequired within parentAlways `equation`
Must equal: equation
Retrieve a page property item — response body — value Title title annotations, href, plain text
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
annotationsModelRequired within parentExpand Retrieve a page property item — response body — value Title title annotations, href, plain text annotations
All rich text objects contain an annotations object that sets the styling for the rich text.
hrefJSONRequired within parentA URL that the rich text object links to or mentions.
href (anyOf 1)stringAlternative
href (anyOf 2)nullAlternative
plain_textstringRequired within parentThe plain text content of the rich text object, without any styling.

Referenced models: Retrieve a page property item — response body — value Title title annotations, href, plain text annotations

Retrieve a page property item — response body — value Title title value Text
FieldTypePresenceDescription and constraints
$objectRoot
textobjectRequired within parentIf a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.
Additional keys: allowed
text.contentstringRequired within parentThe actual text content of the text.
Maximum length: 2000
text.linkJSONRequired within parentAn object with information about any inline link in this text, if included.
text.link (anyOf 1)objectAlternativeAdditional keys: allowed
text.link (anyOf 1).urlstringRequired within parentThe URL of the link.
text.link (anyOf 2)nullAlternative
typestringRequired within parentAlways `text`
Must equal: text
List custom emojis — response body — results item
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
idstringRequired within parentThe ID of the custom emoji.
Format: uuid
namestringRequired within parentThe name of the custom emoji.
urlstringRequired within parentThe URL of the custom emoji.
Retrieve a page property item — response body — value Title title value Mention mention type link preview link preview
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
urlstringRequired within parentThe URL of the link preview mention.
Retrieve a page property item — response body — value Title title value Mention mention type template mention template mention Template Mention Date
FieldTypePresenceDescription and constraints
$objectRootAdditional keys: allowed
template_mention_datestringRequired within parentThe date of the template mention.
Known values: today, now
typestringRequired within parentAlways `template_mention_date`
Must equal: template_mention_date

SDK function policy ID: notion.create_meeting_note. Catalog operation: create_meeting_note. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

Pinned headers: {"Notion-Version": "2026-03-11"}

Official provider source

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.