Skip to main content
POST
Import leads

Authorizations

Authorization
string
header
required

A ManyPI API key (mpi_...) from Settings → API keys, or an OAuth 2.1 access token obtained through the MCP consent flow.

Body

application/json
rows
object[]
required
Required array length: 1 - 100 elements
duplicates
enum<string>
default:merge

merge fills blanks on the existing lead; overwrite lets incoming values win; skip leaves it untouched.

Available options:
merge,
overwrite,
skip
declare_fields
object[]
Maximum array length: 60

Response

Per-row outcome for the chunk.

created
integer
updated
integer
skippedDuplicate
integer
skippedNoIdentity
integer

No email and no domain-plus-name, so there is nothing to file the row under.

skippedOverLimit
integer
skippedOtherWorkspace
integer
failed
object[]
remaining
integer | null

Lead slots left after this batch.

declared
string[]
code
string

lead_limit when the plan filled up mid-import.