Joinotify

Create or update contacts in bulk

POSThttps://api.joinotify.com/contacts/batch

Up to 500 contacts per call, each created or updated by phone or BSUID. The answer is 200 even when rows fail: each row's outcome comes in results, in the order sent.

On an update, only filled values overwrite and tags are added. With options.optIn, new contacts are born with consent and existing ones only get it if they were still unknown — an opt-out is never undone. A batch fires no webhooks.

An API key limited to some numbers gets 403: this operation covers the whole base.

Body Paramsapplication/json

1 required1 optional

array of objectsrequired

up to 500 items

Item 1
stringoptional

max. 40 characters

stringoptional

max. 160 characters

stringoptional

max. 80 characters

stringoptional

max. 80 characters

stringoptional

max. 160 characters

stringoptional

max. 254 characters

stringoptional

max. 10 characters

stringoptional

max. 64 characters

objectoptional
array of stringsoptional

Tag names. Missing ones are created.

up to 20 items

objectoptional

Responses