Crear contacto
https://api.joinotify.com/contactsCrea un contacto a partir de un teléfono o de un BSUID. El teléfono se normaliza a E.164
y se guarda sin el +; sin código de país, indica defaultCountry.
Con ?upsert=true, un contacto que ya existe se actualiza en lugar de responder 409
— y entonces la respuesta es 200, optIn se ignora y tagIds reemplaza las
etiquetas. Envía optIn con la evidencia del consentimiento para crear el contacto ya
apto para recibir marketing.
Una API key restringida a algunos números recibe 403: esta operación es de toda la base.
Query Params
1 opcional(es)
Actualiza el contacto cuando ya existe, en lugar de responder 409.
Valores aceptados:true
Body Paramsapplication/json
11 opcional(es)
Teléfono en formato internacional. Sin código de país, usa defaultCountry.
máx. 40 caracteresacepta null
máx. 160 caracteresacepta null
País (ISO 3166-1 alfa-2) para leer un teléfono sin código de país.
exactamente 2 caracteres
máx. 80 caracteresacepta null
máx. 80 caracteresacepta null
máx. 254 caracteresacepta null
acepta nullformato ^[a-z]{2}(-[A-Z]{2})?$
máx. 64 caracteresacepta null
Parche sobre los campos personalizados. null o "" borran el valor; el formato se valida por el tipo del campo.
Ids de las etiquetas. En la edición, es el conjunto completo.
hasta 50 elementos
Solo en la creación: registra el consentimiento de marketing ya en el alta.