Actualizar contacto

curl -X PATCH 'https://api.mindosoftware.com/api/v1/external/contacts/123/' \
  -H 'X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": [
      {
        "custom_field_id": 45,
        "value": ["calificado"]
      },
      {
        "custom_field_id": 61,
        "value": ["2026-07-20"],
        "expires_at": "2026-12-31T23:59:59-03:00"
      }
    ]
  }'

{
  "contact": {
    "id": 123,
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "phone": "+5491112345678",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": []
  },
  "versioned_custom_fields": [
    {
      "custom_field_id": 45,
      "version": 2
    }
  ]
}

PATCH

api

external

contacts

{contact_id}

curl -X PATCH 'https://api.mindosoftware.com/api/v1/external/contacts/123/' \
  -H 'X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": [
      {
        "custom_field_id": 45,
        "value": ["calificado"]
      },
      {
        "custom_field_id": 61,
        "value": ["2026-07-20"],
        "expires_at": "2026-12-31T23:59:59-03:00"
      }
    ]
  }'

{
  "contact": {
    "id": 123,
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "phone": "+5491112345678",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": []
  },
  "versioned_custom_fields": [
    {
      "custom_field_id": 45,
      "version": 2
    }
  ]
}

Descripción

Este endpoint actualiza parcialmente un contacto no de prueba de la compañía asociada a tu Company API Key. Primero buscá el contacto por teléfono y usá su id como contact_id. La operación es atómica. Si un dato de perfil o campo personalizado es inválido, no se guarda ningún cambio del request.

Si no conocés el id interno del contacto, usá crear o actualizar contacto: identifica al contacto por teléfono y resuelve la sincronización en una sola llamada.

Header de autenticación

string

requerido

Una Company API Key activa. No se admiten API keys legacy, JWT ni keys globales.

string

requerido

Debe ser application/json.

Path parameters

integer

requerido

ID del contacto a actualizar, recibido en la consulta por teléfono.

Campos del body

string | null

Nombre completo del contacto.

string | null

Email del contacto. Puede ser una cadena vacía. Si se informa, debe ser válido.

string

Origen del contacto. Valores válidos: manual, csv_import, organic, whatsapp_sync, instagram_sync, google_contacts, group, api y other.

string | null

Detalle del origen. Puede ser una cadena vacía.

string (URL) | null

URL de la foto de perfil. Puede ser una cadena vacía.

array

Campos personalizados que querés crear o actualizar.

Mostrar Propiedades de cada custom field

integer

requerido

ID del campo personalizado. Debe pertenecer a la lista del contacto.

array

requerido

Valor del campo. Para valores únicos, enviá un solo elemento. Para multiselector, podés enviar varios. [] elimina el valor activo.

string (ISO 8601) | null

Vencimiento opcional. Enviá null para quitarlo. Si lo omitís, se conserva el vencimiento actual.

No podés modificar phone, id, la lista de contactos, identificadores de WhatsApp o Instagram, fechas ni flags internos. Enviar cualquiera de estos campos devuelve 400. Los campos personalizados validan su tipo y sus opciones. Los tipos disponibles son string, text, textarea, int, float, email, url, date, datetime, time, selector y multiselector. No repitas el mismo custom_field_id en un request.

curl -X PATCH 'https://api.mindosoftware.com/api/v1/external/contacts/123/' \
  -H 'X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": [
      {
        "custom_field_id": 45,
        "value": ["calificado"]
      },
      {
        "custom_field_id": 61,
        "value": ["2026-07-20"],
        "expires_at": "2026-12-31T23:59:59-03:00"
      }
    ]
  }'

Respuesta (200 OK)

object

Contacto actualizado, con su perfil y todos los campos personalizados configurados en su lista.

array

Campos personalizados que generaron una versión nueva en esta llamada. Puede ser una lista vacía si no hubo cambios en los valores o vencimientos.

Mostrar Propiedades de cada campo versionado

integer

ID del campo personalizado.

integer

Número de la nueva versión.

{
  "contact": {
    "id": 123,
    "full_name": "Ana Pérez",
    "email": "ana.perez@example.com",
    "phone": "+5491112345678",
    "source": "api",
    "source_detail": "Sincronización ERP",
    "profile_picture": "https://cdn.example.com/ana.jpg",
    "custom_fields": []
  },
  "versioned_custom_fields": [
    {
      "custom_field_id": 45,
      "version": 2
    }
  ]
}

Errores

Estado	Situación
`400`	Campo protegido o no permitido, dato inválido, campo personalizado ajeno al contacto, formato de `expires_at` inválido o `custom_fields` mal formado.
`401`	Falta una Company API Key válida, activa y no vencida.
`404`	El contacto no existe, es de prueba o pertenece a otra compañía.

Comenzar

Cuentas de negocio

Información del negocio

Mensajes

Contactos

Envío masivo

Exportación cualitativa

Actualizar contacto

Descripción

Header de autenticación

Path parameters

Campos del body

Respuesta (200 OK)

Errores

​Descripción

​Header de autenticación

​Path parameters

​Campos del body

​Respuesta (200 OK)

​Errores

Descripción

Header de autenticación

Path parameters

Campos del body

Respuesta (200 OK)

Errores