Skip to main content
POST
Crear o actualizar un contacto

Authorizations

Authorization
string
header
required

La API key de tu organización, con la forma rvm_<prefijo>.<secreto>, enviada como Authorization: Bearer rvm_…. Revem la emite y sólo se muestra una vez; si la pierdes se reemplaza, no se recupera.

Body

application/json

Cualquier otra clave del cuerpo se interpreta como un atributo personalizado del contacto, identificado por su nombre tal como está definido en Revem. Un nombre que no existe responde 422; se aceptan hasta 100 atributos por solicitud.

phone_number
string
required

Teléfono del contacto. Se recomienda formato E.164 (+56912345678); otras grafías se normalizan al guardar. Es la identidad: si ya existe un contacto con este número, se actualiza; si no, se crea.

Minimum string length: 1
first_name
string

Nombre. Si se omite, el valor guardado no cambia.

last_name
string

Apellido. Si se omite, el valor guardado no cambia.

email
string<email>

Si otro contacto del mismo tenant ya tiene este email, se conserva el resto de la solicitud y se informa en warnings.

Response

Contacto creado o actualizado.

ok
boolean
required
id
string<uuid>
required

Identificador del contacto creado o actualizado. Guárdalo: es la clave estable para PATCH /{id} y para webchat.

created
boolean
required

true si la solicitud creó el contacto; false si el teléfono ya existía y se actualizó.

warnings
string[]
required

Avisos sobre una solicitud que SÍ escribió. Hoy el único caso es un email que no se guardó porque pertenece a otro contacto.