Create a contact
https://api.joinotify.com/contactsCreates a contact from a phone number or a BSUID. The phone is normalized to E.164 and
stored without the +; without a country code, send defaultCountry.
With ?upsert=true, a contact that already exists is updated instead of answering
409 — and then the answer is 200, optIn is ignored and tagIds replaces the
tags. Send optIn with the consent evidence to create the contact already able to
receive marketing.
An API key limited to some numbers gets 403: this operation covers the whole base.
Query Params
1 optional
Updates the contact when it already exists, instead of answering 409.
Allowed values:true
Body Paramsapplication/json
11 optional
Phone in international format. Without a country code, use defaultCountry.
max. 40 charactersnullable
max. 160 charactersnullable
Country (ISO 3166-1 alpha-2) to read a phone without a country code.
exactly 2 characters
max. 80 charactersnullable
max. 80 charactersnullable
max. 254 charactersnullable
nullablepattern ^[a-z]{2}(-[A-Z]{2})?$
max. 64 charactersnullable
Patch over the custom fields. null or "" clear the value; the format is validated by the field type.
Tag ids. On an edit, it is the complete set.
up to 50 items
Creation only: records marketing consent at sign-up.