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
}
]
}
Contactos
Actualizar contacto
Actualiza datos y campos personalizados de un contacto de tu compañía
PATCH
/
api
/
v1
/
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á suid 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
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.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
{
"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. |