Los contactos representan a los clientes potenciales registrados en tu cuenta. La API permite consultar la lista, obtener un contacto y actualizarlo.

📘

Una solicitud de contacto registra una interacción. Un contacto reúne la información de la persona a lo largo del tiempo.

Consultar contactos

Haz un GET a /contacts para obtener una lista paginada. Puedes filtrar por las fechas de creación, actualización o última actividad, y por estatus.

curl --request GET \
  --url 'https://api.stagingeb.com/v1/contacts?limit=20&page=1' \
  --header 'Accept: application/json' \
  --header 'X-Authorization: l7u502p8v46ba3ppgvj5y2aad50lb9'

Consulta todos los filtros en List all contacts.

Consultar un contacto

Usa el id recibido en la lista para hacer un GET a /contacts/{contact_id}.

Consulta la respuesta completa en Retrieve a contact.

Actualizar un contacto

Haz un PATCH a /contacts/{contact_id} y envía sólo los campos que deseas cambiar.

Para cambiar el estatus, envía en status el nombre de uno de los estatus de tu cuenta, tal como aparece en EasyBroker. Si el nombre no existe o lo comparten varios estatus, la respuesta es un error 422.

Las listas emails, phones, addresses y tags funcionan de forma distinta: el valor enviado reemplaza la lista completa. Los elementos que no incluyas serán eliminados.

Consulta los campos y ejemplos en Update a contact.