Skip to main content
POST
Bulk create contacts from CSV import Throttled to prevent abuse - max 3 requests per minute per user

Authorizations

Authorization
string
header
required

Bearer token: a Platform API Key (format: ak_live::) or a Personal Access Token (format: rgo-...). PATs always act as the token owner.

Body

application/json
contacts
object[]
required
Maximum array length: 1000
updateExisting
boolean

When true, contacts whose email already exists are updated in place instead of being skipped. Default false preserves the safe "skip duplicates" behavior.

Response

created
number
required

Newly inserted contacts.

updated
number
required

Existing contacts updated in place (only when updateExisting is true).

skipped
number
required

Existing/duplicate contacts left untouched.

failed
number
required

Contacts that hit a technical error.

issues
object[]