Integración de Contactos (CRM)

Upsert de Contacto (Crear o Actualizar)

Sincroniza un contacto/cliente desde el sistema de operación o punto de venta (POS) del aliado comercial hacia GoHighLevel.

🔄 Mecanismo de Upsert (Deduplicación Automática):

  • Si el cliente NO existe: Se crea un nuevo contacto en la subcuenta con su información y se le asigna la sucursal.
  • Si el cliente YA existe (por Email o Teléfono): Se actualizan sus datos y se reasigna la sucursal_asignada a la nueva tienda sin crear registros duplicados.

🏪 Valores válidos para sucursal_asignada:

  • Doral
  • Coral Gables

🔒 Autenticación Requerida:

Es obligatorio incluir tanto x-location-id como x-api-key en las cabeceras HTTP.

post/contacts/upsert

Request

  • Base URL: https://api.facilito.ai (the document declares no server; this is the origin it was published from)
  • URL: https://api.facilito.ai/contacts/upsert
  • Auth: none declared. Required headers: x-location-id, x-api-key

Headers

x-location-idstring required

Identificador único de la subcuenta en GoHighLevel (ej: k6eshf7NoYpyHCCp6PA4)

x-api-keystring required

API Key o Private Token de la subcuenta (ej: pit-24b219c4-08e6-4e2d-9786-4d43e7f6b899)

Request body

firstNamestring required

Nombre del contacto

lastNamestring

Apellido del contacto

emailstring email

Correo electrónico del cliente

phonestring

Teléfono con o sin indicativo internacional (normalizado a E.164 automáticamente)

sucursal_asignada'Doral' | 'Coral Gables'

Tienda o sucursal donde se realizó la compra o registro

tagsstring[]

Etiquetas para segmentación y automatizaciones en el CRM

sourcestring

Origen de la transacción o sistema emisor

Example request

{
  "firstName": "Alex",
  "lastName": "Gómez",
  "email": "alex.gomez@gmail.com",
  "phone": "+13055550199",
  "sucursal_asignada": "Doral",
  "tags": [
    "pos-sneacare",
    "cliente-mostrador"
  ],
  "source": "POS SneaCare"
}

Response

Contacto procesado exitosamente (creado o actualizado)

successboolean
messagestring
action'created' | 'updated'

Example response

{
  "success": true,
  "message": "Contacto creado exitosamente en GHL",
  "action": "created",
  "contact": {
    "id": "9omOrA3oAotlPItaDypc",
    "firstName": "Alex",
    "lastName": "Gómez",
    "email": "alex.gomez@gmail.com",
    "phone": "+13055550199",
    "locationId": "k6eshf7NoYpyHCCp6PA4",
    "isNew": true,
    "action": "created"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.