Skip to main content
POST
Bulk insert records

Authorizations

X-API-KEY
string
header
required

Your deployment's API key (MMK_API_KEY).

X-Notion-Token
string
header
required

Your Notion integration token / internal token. Supplied by the caller (not stored server-side).

Body

application/json

Provide one of data_source_id / notion_id / database_id to identify the target (priority: data_source_id > notion_id > database_id).

records
object[]
required

Simple property maps, one per page (max 100).

database_id
string

Legacy database ID.

data_source_id
string

Data source ID (multi-data-source databases).

notion_id
string

Auto-detect — accepts either a database or data source ID.

config
object

Optional concurrency/retry config.

page_options
object

Global page-creation options applied to every created page.

Response

Per-record insert results

success
boolean
total
integer
successful
integer
failed
integer
results
object[]
failed_data
object[]
error_message
string