Zernio
Zernio
API Reference

Contacts

List contactsGETCreate contactPOSTList channels for a contactGETGet contactGETUpdate contactPATCHDelete contactDELETEBulk create contactsPOST
Dashboard
llms.txtOpenAPI
OverviewPlatformsAPI ReferenceResources
Contacts

Bulk create contacts

Import up to 1000 contacts at a time. Skips duplicates, merging any new tags onto the existing contact. accountId is required whenever contacts carry a platformIdentifier (or a row-level accountId); platform is always derived from the resolved account, never used to decide whether channels are created, and a mismatched platform 404s as account not found. When accountId is set, each contact must carry a platformIdentifier; a row missing it is rejected individually (reported in errors[], HTTP 200), not a 400 for the whole import. On phone platforms (whatsapp, sms) the platformIdentifier is normalized to digits and a value that is not phone-shaped is rejected per contact and reported in errors[], not imported.

POST
/v1/contacts/bulk

Authorization

bearerAuth
AuthorizationBearer <token>

API key authentication: send your Zernio API key in the Authorization header, prefixed with Bearer.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

{  "success": true,  "created": 0,  "skipped": 0,  "errors": [    "string"  ],  "total": 0}
Was this page helpful?

Delete contact

Permanently deletes a contact and all associated channels.

List custom field definitions

Returns all custom field definitions. Optionally filter by profile.

profileId*string
accountId?string

Required when contacts carry channel data (platformIdentifier or a row-level accountId). Omit for a plain CRM import with no channels.

platform?string

Ignored when accountId is set: the platform is derived from the resolved account. Only relevant to disambiguate accountId lookup; a mismatch 404s.

contacts*array<>
Itemsitems <= 1000