Create or update contacts in bulk
POST
https://api.joinotify.com/contacts/batchUp 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