Actualizar contacto externo

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 obtené 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.

Header de autenticación

X-API-Key

string

requerido

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

Content-Type

string

requerido

Debe ser application/json.

Path parameters

contact_id

integer

requerido

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

Campos del body

full_name

string | null

Nombre completo del contacto.

string | null

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

source

string

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

source_detail

string | null

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

profile_picture

string (URL) | null

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

custom_fields

array

Campos personalizados que querés crear o actualizar.

Mostrar Propiedades de cada custom field

custom_field_id

integer

requerido

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

value

array

requerido

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

expires_at

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)

contact

object

Contacto actualizado, con la misma estructura que la respuesta de obtener contacto.

versioned_custom_fields

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

custom_field_id

integer

ID del campo personalizado.

version

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.

Obtener contacto externo Enviar masivo

Comenzar

Cuentas de negocio

Información del negocio

Mensajes

Contactos

Contactos externos

Envío masivo

Exportación cualitativa

Actualizar contacto externo

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