Create a meeting note

TypeScript SDK

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
    }
  }
})

curl --request POST \
  --url https://api.notion.com/v1/blocks/meeting_notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "source": {
    "type": "<string>",
    "file_upload_id": "<string>"
  },
  "title": "<string>",
  "options": {
    "kickoff_summary": true
  }
}
'

import requests

url = "https://api.notion.com/v1/blocks/meeting_notes"

payload = {
    "source": {
        "type": "<string>",
        "file_upload_id": "<string>"
    },
    "title": "<string>",
    "options": { "kickoff_summary": True }
}
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/v1/blocks/meeting_notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source' => [
        'type' => '<string>',
        'file_upload_id' => '<string>'
    ],
    'title' => '<string>',
    'options' => [
        'kickoff_summary' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/v1/blocks/meeting_notes"

	payload := strings.NewReader("{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.notion.com/v1/blocks/meeting_notes")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/v1/blocks/meeting_notes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "unauthorized",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "row_limit_exceeded",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "rate_limited",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "internal_server_error",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_unavailable",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "gateway_timeout",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_overload",
  "status": "<unknown>",
  "additional_data": {}
}

POST

blocks

meeting_notes

TypeScript SDK

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
    }
  }
})

curl --request POST \
  --url https://api.notion.com/v1/blocks/meeting_notes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Notion-Version: <notion-version>' \
  --data '
{
  "source": {
    "type": "<string>",
    "file_upload_id": "<string>"
  },
  "title": "<string>",
  "options": {
    "kickoff_summary": true
  }
}
'

import requests

url = "https://api.notion.com/v1/blocks/meeting_notes"

payload = {
    "source": {
        "type": "<string>",
        "file_upload_id": "<string>"
    },
    "title": "<string>",
    "options": { "kickoff_summary": True }
}
headers = {
    "Notion-Version": "<notion-version>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.notion.com/v1/blocks/meeting_notes",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'source' => [
        'type' => '<string>',
        'file_upload_id' => '<string>'
    ],
    'title' => '<string>',
    'options' => [
        'kickoff_summary' => true
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Notion-Version: <notion-version>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.notion.com/v1/blocks/meeting_notes"

	payload := strings.NewReader("{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Notion-Version", "<notion-version>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.notion.com/v1/blocks/meeting_notes")
  .header("Notion-Version", "<notion-version>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.notion.com/v1/blocks/meeting_notes")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Notion-Version"] = '<notion-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"source\": {\n    \"type\": \"<string>\",\n    \"file_upload_id\": \"<string>\"\n  },\n  \"title\": \"<string>\",\n  \"options\": {\n    \"kickoff_summary\": true\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "object": "<string>",
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "unauthorized",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "row_limit_exceeded",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "rate_limited",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "internal_server_error",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_unavailable",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "gateway_timeout",
  "status": "<unknown>",
  "additional_data": {}
}

{
  "object": "<unknown>",
  "message": "<string>",
  "code": "service_overload",
  "status": "<unknown>",
  "additional_data": {}
}

Creates a meeting notes block 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 has a status of uploaded before calling this endpoint. See 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 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 and Notion 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 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

source

object

required

Audio or video source for the meeting note.

Option 1
Option 2

Show child attributes

parent

object

Parent page for the new meeting note. Required when source.type is file_upload.

Show child attributes

title

string

Title for the meeting note.

Maximum string length: 2000

language

enum<string>

Language hint for transcription. Defaults to automatic detection.

Available options:

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

options

object

Optional processing settings.

Show child attributes

Response

Option 1
Option 2

object

string

required

Always "block".

Allowed value: "block"

string<uuid>

required

The ID of the meeting note block.

Delete a block

Query meeting notes

⌘I

Notion API

Objects

Endpoints

Webhook events

Create a meeting note

Processing status

Requirements

Errors

Authorizations

Headers

Body

Response

​Processing status

​Requirements

​Errors

Authorizations

Headers

Body

Response

Processing status

Requirements

Errors