Lista y consulta contactos con un conjunto básico de datos, crea contactos nuevos y edita nombre, teléfono, correo y tipo.
Permisos#
| Permiso | Para qué sirve | Tipo |
|---|---|---|
contactos:leer | Listar y ver contactos | lectura |
contactos:escribir | Crear y editar contactos | escritura |
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ámetro | Descripción |
|---|---|
q | texto libre |
email | correo exacto |
telefono | teléfono |
actualizado_desde | fecha (2026-01-31) |
limite | 1 a 100 |
pagina | página |
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos?q=valor" \
-H "Authorization: Bearer cnx_TU_LLAVE"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();$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
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/contactos/{id}" \
-H "Authorization: Bearer cnx_TU_LLAVE"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();$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)#
| Campo | Descripción |
|---|---|
nombre | obligatorio |
apellidos | opcional |
telefono | opcional |
email | opcional |
tipo_contacto_id | opcional |
whatsapp | opcional: true si el teléfono también tiene WhatsApp |
numero_documento | opcional |
tipo_documento | opcional: nombre («Cédula de ciudadanía») o id |
pais | opcional: código (CO) o nombre |
departamento | opcional: nombre o id |
ciudad | opcional: nombre o id |
direccion | opcional |
{
"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"
}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"}'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();$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)#
| Campo | Descripción |
|---|---|
nombre | opcional |
apellidos | opcional |
telefono | opcional |
whatsapp | opcional: true para marcar el teléfono como número de WhatsApp |
email | opcional |
tipo_contacto_id | opcional |
pais | opcional: código (CO) o nombre |
departamento | opcional: nombre o id |
ciudad | opcional: nombre o id |
direccion | opcional |
numero_documento | opcional: solo se completa si el contacto no tiene uno |
tipo_documento | opcional: solo se completa si el contacto no tiene uno |
{
"telefono": "+57 311 000 0000",
"pais": "Colombia",
"departamento": "Antioquia",
"ciudad": "Medellín"
}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"}'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();$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);