> ## Documentation Index
> Fetch the complete documentation index at: https://developers.notion.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create a meeting note
> Creates AI meeting notes from an uploaded audio or video file.
Creates a [meeting notes block](/reference/block#meeting-notes) and begins processing its source media. The response includes the ID of the created block. A full block response also includes its current processing status.
Source types allow you to directly attach a file upload, or create a meeting note block from an existing audio or video file block:
| Source | Body parameters | Behavior |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| Completed file upload | Set `source.type` to `file_upload`, provide `source.file_upload_id`, set `parent.type` to `page_id`, and provide `parent.page_id`. | Creates the meeting notes block in the parent page. |
| Existing block | Set `source.type` to `block` and provide `source.block_id` for an audio, video, or file block backed by a Notion-hosted audio or video upload. Omit `parent`. | Creates the meeting notes block next to the source block. |
For a file upload source, upload the media and wait until the [file upload](/reference/file-upload) has a status of `uploaded` before calling this endpoint. See [Uploading small files](/guides/data-apis/uploading-small-files) for the complete upload flow.
For a `.m4a` audio file, use the `audio/mp4` content type. WebM audio is not supported.
### Processing status
Processing continues asynchronously after the endpoint returns. Use [Retrieve a block](/reference/retrieve-a-block) with the returned block ID and check `meeting_notes.status`. When summary generation is enabled, wait for `notes_ready` before retrieving the generated summary and notes from the IDs in `meeting_notes.children`.
By default, Notion starts summary generation after transcription. Set `options.kickoff_summary` to `false` to transcribe the media without generating a summary.
If you provide a `title` and enable summary generation, treat the title as provisional. Notion may replace it when processing completes.
This endpoint is not idempotent. Retrying a request may create duplicate meeting notes blocks.
### Requirements
The integration must have the **Insert content** capability. **Read content** is also required to use an existing block as the source or receive the full meeting notes block in the response. Without **Read content**, a request using a file upload source returns only the created block's `object` and `id`.
The user associated with the integration must also have access to AI meeting notes. See the [capabilities guide](/reference/capabilities) and [Notion pricing](https://www.notion.com/pricing).
### Errors
Returns a 400 HTTP response if AI meeting notes are not available to the integration's user or if the request contains an invalid source, parent, or processing option.
Each Public API endpoint can return several possible error codes. See the [Error codes section](/reference/status-codes#error-codes) for more information.
## OpenAPI
````yaml post /v1/blocks/meeting_notes
openapi: 3.1.0
info:
title: Notion API
version: 1.0.0
termsOfService: >-
https://notion.notion.site/Terms-and-Privacy-28ffdd083dc3473e9c2da6ec011b58ac
servers:
- url: https://api.notion.com
security:
- bearerAuth: []
tags:
- name: Databases
description: Database endpoints
- name: Data sources
description: Data source endpoints
- name: Pages
description: Page endpoints
- name: Async tasks
description: Async task endpoints
- name: Blocks
description: Block endpoints
- name: Comments
description: Comment endpoints
- name: File uploads
description: File upload endpoints
- name: OAuth
description: OAuth endpoints (basic authentication)
- name: Users
description: User endpoints
- name: Search
description: Search endpoints
- name: Views
description: View endpoints
- name: Custom emojis
description: Custom emoji endpoints
- name: Meeting notes
description: Meeting notes endpoints
paths:
/v1/blocks/meeting_notes:
post:
tags:
- Meeting notes
summary: Create a meeting note
operationId: create-meeting-note
parameters:
- $ref: '#/components/parameters/notionVersion'
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
source:
oneOf:
- type: object
properties:
type:
type: string
const: file_upload
description: Always "file_upload".
file_upload_id:
$ref: '#/components/schemas/idRequest'
description: ID of a completed public API file upload.
additionalProperties: false
required:
- type
- file_upload_id
- type: object
properties:
type:
type: string
const: block
description: Always "block".
block_id:
$ref: '#/components/schemas/idRequest'
description: ID of an existing audio, video, or file block.
additionalProperties: false
required:
- type
- block_id
description: Audio or video source for the meeting note.
parent:
type: object
properties:
type:
type: string
const: page_id
description: Always "page_id".
page_id:
$ref: '#/components/schemas/idRequest'
description: >-
Page ID where the meeting note should be created.
Required for file_upload sources.
additionalProperties: false
required:
- type
- page_id
description: >-
Parent page for the new meeting note. Required when
source.type is file_upload.
title:
type: string
maxLength: 2000
description: Title for the meeting note.
language:
type: string
enum:
- 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
description: >-
Language hint for transcription. Defaults to automatic
detection.
options:
type: object
properties:
kickoff_summary:
type: boolean
description: Whether to start summary generation after transcription.
additionalProperties: false
description: Optional processing settings.
required:
- source
responses:
'200':
description: ''
content:
application/json:
schema:
oneOf:
- type: object
properties:
object:
type: string
const: block
description: Always "block".
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the meeting note block.
additionalProperties: false
required:
- object
- id
- type: object
properties:
object:
type: string
const: block
description: Always "block".
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the meeting note block.
type:
type: string
const: meeting_notes
description: Always "meeting_notes".
meeting_notes:
type: object
properties:
title:
type: array
items:
$ref: '#/components/schemas/richTextItemResponse'
maxItems: 100
description: Title of the meeting note as rich text.
status:
type: string
enum:
- transcription_not_started
- transcription_paused
- transcription_in_progress
- transcription_failed
- summary_in_progress
- notes_ready
description: >-
Current processing status of the meeting note
transcription.
children:
type: object
properties:
summary_block_id:
$ref: '#/components/schemas/idResponse'
description: Block ID of the AI summary tab.
notes_block_id:
$ref: '#/components/schemas/idResponse'
description: Block ID of the meeting notes tab.
transcript_block_id:
$ref: '#/components/schemas/idResponse'
description: Block ID of the transcript tab.
additionalProperties: false
description: >-
Block IDs for each tab (summary, notes,
transcript).
calendar_event:
type: object
properties:
start_time:
type: string
description: ISO-8601 start time of the calendar event.
end_time:
type: string
description: ISO-8601 end time of the calendar event.
attendees:
type: array
items:
$ref: '#/components/schemas/idResponse'
maxItems: 100
description: List of attendee user IDs.
additionalProperties: false
required:
- start_time
- end_time
description: >-
Calendar event metadata associated with this
meeting note.
recording:
type: object
properties:
start_time:
type: string
description: ISO-8601 timestamp when the recording started.
end_time:
type: string
description: ISO-8601 timestamp when the recording ended.
additionalProperties: false
description: Start and end times of the actual recording.
additionalProperties: false
description: Meeting note content fields.
created_time:
type: string
description: ISO-8601 timestamp when this meeting note was created.
last_edited_time:
type: string
description: >-
ISO-8601 timestamp when this meeting note was last
edited.
created_by:
$ref: '#/components/schemas/partialUserObjectResponse'
description: User who created this meeting note.
last_edited_by:
$ref: '#/components/schemas/partialUserObjectResponse'
description: User who last edited this meeting note.
has_children:
type: boolean
description: Whether this block has child blocks.
in_trash:
type: boolean
description: Whether this meeting note is in the trash.
additionalProperties: false
required:
- object
- id
- type
- meeting_notes
- created_time
- last_edited_time
- created_by
- last_edited_by
- has_children
- in_trash
'400':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_400'
'401':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_401'
'403':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_403'
'404':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_404'
'406':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_406'
'409':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_409'
'429':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_429'
'500':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_500'
'503':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_503'
'504':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_504'
'529':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/error_api_529'
x-codeSamples:
- lang: javascript
label: TypeScript SDK
source: |-
import { Client } from "@notionhq/client"
const notion = new Client({ auth: process.env.NOTION_API_KEY })
const response = await notion.request({
method: "post",
path: "blocks/meeting_notes",
body: {
source: {
type: "file_upload",
file_upload_id: "a02fc1d3-db8b-45c5-a222-27595b15aea7"
},
parent: {
type: "page_id",
page_id: "c02fc1d3-db8b-45c5-a222-27595b15aea7"
},
title: "Weekly sync",
language: "en",
options: {
kickoff_summary: true
}
}
})
components:
parameters:
notionVersion:
name: Notion-Version
in: header
required: true
schema:
enum:
- '2026-03-11'
description: >-
The [API version](/reference/versioning) to use for this request. The
latest version is `2026-03-11`.
schemas:
idRequest:
type: string
idResponse:
type: string
format: uuid
richTextItemResponse:
allOf:
- $ref: '#/components/schemas/richTextItemResponseCommon'
- oneOf:
- $ref: '#/components/schemas/textRichTextItemResponse'
- $ref: '#/components/schemas/mentionRichTextItemResponse'
- $ref: '#/components/schemas/equationRichTextItemResponse'
partialUserObjectResponse:
type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
object:
type: string
const: user
description: Always `user`
additionalProperties: false
required:
- id
- object
error_api_400:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- invalid_json
- invalid_request_url
- invalid_request
- missing_version
- validation_error
status:
const: 400
required:
- code
- status
additionalProperties: false
error_api_401:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- unauthorized
status:
const: 401
required:
- code
- status
additionalProperties: false
error_api_403:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- restricted_resource
- status_change_not_allowed
status:
const: 403
required:
- code
- status
additionalProperties: false
error_api_404:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- object_not_found
- directory_not_found
status:
const: 404
required:
- code
- status
additionalProperties: false
error_api_406:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- row_limit_exceeded
status:
const: 406
required:
- code
- status
additionalProperties: false
error_api_409:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- conflict_error
- agent_deleted
status:
const: 409
required:
- code
- status
additionalProperties: false
error_api_429:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- rate_limited
status:
const: 429
required:
- code
- status
additionalProperties: false
error_api_500:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- internal_server_error
status:
const: 500
required:
- code
- status
additionalProperties: false
error_api_503:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- service_unavailable
status:
const: 503
required:
- code
- status
additionalProperties: false
error_api_504:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- gateway_timeout
status:
const: 504
required:
- code
- status
additionalProperties: false
error_api_529:
allOf:
- $ref: '#/components/schemas/publicApiCommonErrorResponse'
- type: object
properties:
code:
enum:
- service_overload
status:
const: 529
required:
- code
- status
additionalProperties: false
richTextItemResponseCommon:
type: object
properties:
plain_text:
type: string
description: The plain text content of the rich text object, without any styling.
href:
oneOf:
- type: string
- type: 'null'
description: A URL that the rich text object links to or mentions.
annotations:
$ref: '#/components/schemas/annotationResponse'
description: >-
All rich text objects contain an annotations object that sets the
styling for the rich text.
additionalProperties: false
required:
- plain_text
- href
- annotations
textRichTextItemResponse:
type: object
properties:
type:
type: string
const: text
description: Always `text`
text:
type: object
properties:
content:
type: string
maxLength: 2000
description: The actual text content of the text.
link:
oneOf:
- type: object
properties:
url:
type: string
examples:
- https://www.notion.com
description: The URL of the link.
additionalProperties: false
required:
- url
- type: 'null'
description: >-
An object with information about any inline link in this text,
if included.
additionalProperties: false
required:
- content
- link
description: >-
If 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.
required:
- type
- text
title: Text
mentionRichTextItemResponse:
type: object
properties:
type:
type: string
const: mention
description: Always `mention`
mention:
oneOf:
- type: object
properties:
type:
type: string
const: user
description: Always `user`
user:
$ref: '#/components/schemas/userValueResponse'
description: Details of the user mention.
additionalProperties: false
required:
- type
- user
title: User
- type: object
properties:
type:
type: string
const: date
description: Always `date`
date:
$ref: '#/components/schemas/dateResponse'
description: Details of the date mention.
additionalProperties: false
required:
- type
- date
title: Date
- type: object
properties:
type:
type: string
const: link_preview
description: Always `link_preview`
link_preview:
$ref: '#/components/schemas/linkPreviewMentionResponse'
description: Details of the link preview mention.
additionalProperties: false
required:
- type
- link_preview
title: Link Preview
- type: object
properties:
type:
type: string
const: link_mention
description: Always `link_mention`
link_mention:
$ref: '#/components/schemas/linkMentionResponse'
description: Details of the link mention.
additionalProperties: false
required:
- type
- link_mention
title: Link Mention
- type: object
properties:
type:
type: string
const: page
description: Always `page`
page:
type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the page in the mention.
additionalProperties: false
required:
- id
description: Details of the page mention.
additionalProperties: false
required:
- type
- page
title: Page
- type: object
properties:
type:
type: string
const: database
description: Always `database`
database:
type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the database in the mention.
additionalProperties: false
required:
- id
description: Details of the database mention.
additionalProperties: false
required:
- type
- database
title: Database
- type: object
properties:
type:
type: string
const: template_mention
description: Always `template_mention`
template_mention:
$ref: '#/components/schemas/templateMentionResponse'
description: Details of the template mention.
additionalProperties: false
required:
- type
- template_mention
title: Template Mention
- type: object
properties:
type:
type: string
const: custom_emoji
description: Always `custom_emoji`
custom_emoji:
$ref: '#/components/schemas/customEmojiResponse'
description: Details of the custom emoji mention.
additionalProperties: false
required:
- type
- custom_emoji
title: Custom Emoji
description: >-
Mention objects represent an inline mention of a database, date,
link preview mention, page, template mention, or user. A mention is
created in the Notion UI when a user types `@` followed by the name
of the reference.
required:
- type
- mention
title: Mention
equationRichTextItemResponse:
type: object
properties:
type:
type: string
const: equation
description: Always `equation`
equation:
type: object
properties:
expression:
type: string
examples:
- e=mc^2
description: A KaTeX compatible string.
additionalProperties: false
required:
- expression
description: >-
Notion supports inline LaTeX equations as rich text objects with a
type value of `equation`.
required:
- type
- equation
title: Equation
publicApiCommonErrorResponse:
type: object
properties:
object:
const: error
message:
type: string
additional_data:
type: object
additionalProperties:
oneOf:
- type: string
- type: array
items:
type: string
required:
- object
- message
annotationResponse:
type: object
properties:
bold:
type: boolean
italic:
type: boolean
strikethrough:
type: boolean
underline:
type: boolean
code:
type: boolean
color:
$ref: '#/components/schemas/apiColor'
additionalProperties: false
required:
- bold
- italic
- strikethrough
- underline
- code
- color
userValueResponse:
oneOf:
- $ref: '#/components/schemas/partialUserObjectResponse'
- $ref: '#/components/schemas/userObjectResponse'
dateResponse:
type: object
properties:
start:
type: string
format: date
description: The start date of the date object.
end:
oneOf:
- type: string
format: date
- type: 'null'
description: The end date of the date object, if any.
time_zone:
oneOf:
- $ref: '#/components/schemas/timeZoneRequest'
- type: 'null'
description: The time zone of the date object.
additionalProperties: false
required:
- start
- end
- time_zone
linkPreviewMentionResponse:
type: object
properties:
url:
type: string
description: The URL of the link preview mention.
additionalProperties: false
required:
- url
linkMentionResponse:
type: object
properties:
href:
type: string
description: The href of the link mention.
title:
type: string
description: The title of the link.
description:
type: string
description: The description of the link.
link_author:
type: string
description: The author of the link.
link_provider:
type: string
description: The provider of the link.
thumbnail_url:
type: string
description: The thumbnail URL of the link.
icon_url:
type: string
description: The icon URL of the link.
iframe_url:
type: string
description: The iframe URL of the link.
height:
type: integer
description: The height of the link preview iframe.
padding:
type: integer
description: The padding of the link preview iframe.
padding_top:
type: integer
description: The top padding of the link preview iframe.
additionalProperties: false
required:
- href
templateMentionResponse:
oneOf:
- $ref: '#/components/schemas/templateMentionDateTemplateMentionResponse'
- $ref: '#/components/schemas/templateMentionUserTemplateMentionResponse'
customEmojiResponse:
type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the custom emoji.
name:
type: string
description: The name of the custom emoji.
url:
type: string
description: The URL of the custom emoji.
additionalProperties: false
required:
- id
- name
- url
apiColor:
type: string
enum:
- default
- gray
- brown
- orange
- yellow
- green
- blue
- purple
- pink
- red
- default_background
- gray_background
- brown_background
- orange_background
- yellow_background
- green_background
- blue_background
- purple_background
- pink_background
- red_background
description: >-
One of: `default`, `gray`, `brown`, `orange`, `yellow`, `green`, `blue`,
`purple`, `pink`, `red`, `default_background`, `gray_background`,
`brown_background`, `orange_background`, `yellow_background`,
`green_background`, `blue_background`, `purple_background`,
`pink_background`, `red_background`
userObjectResponse:
allOf:
- $ref: '#/components/schemas/userObjectResponseCommon'
- oneOf:
- $ref: '#/components/schemas/personUserObjectResponse'
- $ref: '#/components/schemas/botUserObjectResponse'
timeZoneRequest:
type: string
templateMentionDateTemplateMentionResponse:
type: object
properties:
type:
type: string
const: template_mention_date
description: Always `template_mention_date`
template_mention_date:
type: string
enum:
- today
- now
description: The date of the template mention.
additionalProperties: false
required:
- type
- template_mention_date
title: Template Mention Date
templateMentionUserTemplateMentionResponse:
type: object
properties:
type:
type: string
const: template_mention_user
description: Always `template_mention_user`
template_mention_user:
type: string
const: me
description: The user of the template mention.
additionalProperties: false
required:
- type
- template_mention_user
title: Template Mention User
userObjectResponseCommon:
type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the user.
object:
type: string
const: user
description: The user object type name.
name:
oneOf:
- type: string
- type: 'null'
description: The name of the user.
avatar_url:
oneOf:
- type: string
- type: 'null'
description: The avatar URL of the user.
additionalProperties: false
required:
- id
- object
- name
- avatar_url
personUserObjectResponse:
type: object
properties:
type:
type: string
const: person
description: Indicates this user is a person.
person:
type: object
properties:
email:
type: string
description: The email of the person.
email_verified:
type: boolean
description: Whether the person's email is verified.
additionalProperties: false
description: Details about the person, when the `type` of the user is `person`.
required:
- type
- person
title: Person
botUserObjectResponse:
type: object
properties:
type:
type: string
const: bot
description: Indicates this user is a bot.
bot:
oneOf:
- $ref: '#/components/schemas/emptyObject'
- $ref: '#/components/schemas/botInfoResponse'
description: Details about the bot, when the `type` of the user is `bot`.
required:
- type
- bot
title: Bot
emptyObject:
type: object
properties: {}
additionalProperties: false
botInfoResponse:
type: object
properties:
owner:
oneOf:
- type: object
properties:
type:
type: string
const: user
description: Always `user`
user:
oneOf:
- type: object
properties:
id:
$ref: '#/components/schemas/idResponse'
description: The ID of the user.
object:
type: string
const: user
description: The user object type name.
name:
oneOf:
- type: string
- type: 'null'
description: The name of the user.
avatar_url:
oneOf:
- type: string
- type: 'null'
description: The avatar URL of the user.
type:
type: string
const: person
description: The type of the user.
person:
type: object
properties:
email:
type: string
description: The email of the person.
email_verified:
type: boolean
description: Whether the person's email is verified.
additionalProperties: false
description: The person info of the user.
additionalProperties: false
required:
- id
- object
- name
- avatar_url
- type
- person
- $ref: '#/components/schemas/partialUserObjectResponse'
description: >-
Details about the owner of the bot, when the `type` of the
owner is `user`. This means the bot is for a integration.
additionalProperties: false
required:
- type
- user
title: User
- type: object
properties:
type:
type: string
const: workspace
description: Always `workspace`
workspace:
type: boolean
const: true
description: >-
Details about the owner of the bot, when the `type` of the
owner is `workspace`. This means the bot is for an internal
integration.
additionalProperties: false
required:
- type
- workspace
title: Workspace
description: Details about the owner of the bot.
workspace_id:
type: string
description: The ID of the bot's workspace.
workspace_limits:
type: object
properties:
max_file_upload_size_in_bytes:
type: integer
minimum: 0
description: The maximum allowable size of a file upload, in bytes
additionalProperties: false
required:
- max_file_upload_size_in_bytes
description: Limits and restrictions that apply to the bot's workspace
workspace_name:
oneOf:
- type: string
- type: 'null'
description: The name of the bot's workspace.
additionalProperties: false
required:
- owner
- workspace_id
- workspace_limits
- workspace_name
securitySchemes:
bearerAuth:
type: http
scheme: bearer
````