Skip to main content
POST
Bulk upsert 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
records
object[]
required
lookup_properties
string[]
required

Property names used to match existing records.

database_id
string
data_source_id
string
notion_id
string
update_properties
string[]

Optional — properties to update on conflict (default: all except lookup).

config
object

Optional concurrency/retry config.

page_options
object

Global page-creation options applied to every created page.

Response

Per-record upsert results (action = insert|update)

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