Ir al contenido
Documentación de Connecto
connecto.lat
API para desarrolladoresReferencia

Contactos (listar, crear y editar)

Lista y consulta contactos con un conjunto básico de datos, crea contactos nuevos y edita nombre, teléfono, correo y tipo.

Permisos#

PermisoPara qué sirveTipo
contactos:leerListar y ver contactoslectura
contactos:escribirCrear y editar contactosescritura

Endpoints#

GET /contactos#

Lista contactos. Filtros: q (texto libre), email, telefono, actualizado_desde, limite, pagina.

Permiso: contactos:leer · lectura

Parámetros de la consulta#

ParámetroDescripción
qtexto libre
emailcorreo exacto
telefonoteléfono
actualizado_desdefecha (2026-01-31)
limite1 a 100
paginapágina
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos?q=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos?q=valor", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos?q=valor");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

GET /contactos/{id}#

Un contacto por su id.

Permiso: contactos:leer · lectura

Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

POST /contactos#

Crea un contacto (exige nombre y, al menos, teléfono o correo). Opcionalmente guarda su documento y su ubicación (se validan contra los catálogos; lo que no se pueda aplicar se omite y se informa en «advertencias»). Si ya existe un contacto con ese teléfono, correo o número de documento responde 409 con su id.

Permiso: contactos:escribir · escritura

Cuerpo (JSON)#

CampoDescripción
nombreobligatorio
apellidosopcional
telefonoopcional
emailopcional
tipo_contacto_idopcional
whatsappopcional: true si el teléfono también tiene WhatsApp
numero_documentoopcional
tipo_documentoopcional: nombre («Cédula de ciudadanía») o id
paisopcional: código (CO) o nombre
departamentoopcional: nombre o id
ciudadopcional: nombre o id
direccionopcional
Ejemplo de cuerpo
{
  "nombre": "Ana Pérez",
  "telefono": "+57 300 123 4567",
  "email": "[email protected]",
  "numero_documento": "1020304050",
  "tipo_documento": "Cédula de ciudadanía",
  "pais": "Colombia",
  "departamento": "Antioquia",
  "ciudad": "Medellín"
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Ana Pérez","telefono":"+57 300 123 4567","email":"[email protected]","numero_documento":"1020304050","tipo_documento":"Cédula de ciudadanía","pais":"Colombia","departamento":"Antioquia","ciudad":"Medellín"}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "nombre": "Ana Pérez",
    "telefono": "+57 300 123 4567",
    "email": "[email protected]",
    "numero_documento": "1020304050",
    "tipo_documento": "Cédula de ciudadanía",
    "pais": "Colombia",
    "departamento": "Antioquia",
    "ciudad": "Medellín"
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'nombre' => 'Ana Pérez',
  'telefono' => '+57 300 123 4567',
  'email' => '[email protected]',
  'numero_documento' => '1020304050',
  'tipo_documento' => 'Cédula de ciudadanía',
  'pais' => 'Colombia',
  'departamento' => 'Antioquia',
  'ciudad' => 'Medellín',
)),
]);
$datos = json_decode(curl_exec($ch), true);

PATCH /contactos/{id}#

Edita nombre, apellidos, teléfono, correo, tipo de contacto y la ubicación (país, departamento, ciudad y dirección). La ubicación se envía por nombre o por id/código y se valida contra los catálogos; lo que no se pueda aplicar (un nombre que no está en el catálogo o un campo desactivado en Configuración › Contactos) se omite y se informa en «advertencias» sin impedir el resto.

Permiso: contactos:escribir · escritura

Cuerpo (JSON)#

CampoDescripción
nombreopcional
apellidosopcional
telefonoopcional
whatsappopcional: true para marcar el teléfono como número de WhatsApp
emailopcional
tipo_contacto_idopcional
paisopcional: código (CO) o nombre
departamentoopcional: nombre o id
ciudadopcional: nombre o id
direccionopcional
numero_documentoopcional: solo se completa si el contacto no tiene uno
tipo_documentoopcional: solo se completa si el contacto no tiene uno
Ejemplo de cuerpo
{
  "telefono": "+57 311 000 0000",
  "pais": "Colombia",
  "departamento": "Antioquia",
  "ciudad": "Medellín"
}
Ejemplo en curl
curl -X PATCH "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"telefono":"+57 311 000 0000","pais":"Colombia","departamento":"Antioquia","ciudad":"Medellín"}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}", {
  method: "PATCH",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "telefono": "+57 311 000 0000",
    "pais": "Colombia",
    "departamento": "Antioquia",
    "ciudad": "Medellín"
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'telefono' => '+57 311 000 0000',
  'pais' => 'Colombia',
  'departamento' => 'Antioquia',
  'ciudad' => 'Medellín',
)),
]);
$datos = json_decode(curl_exec($ch), true);
¿Te fue útil esta página?
Última actualización: 14/11/2026