Skip to main content
POST
Verificar identificadores de contacto

Autorizaciones

Authorization
string
header
requerido

Token JWT de autenticación

Encabezados

x-company-id
string

Identificador de la empresa objetivo. Obligatorio solo para API keys globales (type=global). Se ignora para API keys de empresa y usuarios humanos.

Cuerpo

application/json
email
string

Correo electrónico a verificar. Solo cuenta como identificador si tiene "@".

linkedin_identifier
string

URL del perfil de LinkedIn o solo el nombre del perfil.

phone_number
string

Teléfono (código de área + número, sin el código de país). Un teléfono que no forma un número válido se ignora en la verificación.

country_code
string

Código de país del teléfono. Ejemplo: 55.

exclude_contact_id
string

Contacto a ignorar en la verificación. La edición envía el propio contacto: un valor igual al suyo no es conflicto.

Pattern: ^[0-9a-fA-F]{24}$

Respuesta

200 - application/json

Resultado de la verificación

status
enum<string>
requerido

new: ningún contacto tiene los identificadores. existing: el POST reutilizaría contact. conflict: identificadores distintos apuntan a contactos distintos.

Opciones disponibles:
new,
existing,
conflict
matched_by
enum<string> | null
requerido

Identificador que coincidió

Opciones disponibles:
email,
linkedin,
phone
matches_count
number
requerido

Cuántos contactos de la empresa coincidieron por la clave matched_by.

contact
object | null
requerido

Contacto que se reutilizaría. null en new y conflict.

conflicts
object[]
requerido

En conflict, el contacto de cada identificador. Vacío en los demás casos.