Skip to main content

​
Paginación

Los listados paginados devuelven { data, nextCursor }, ordenados por updatedAt ascendente. limit admite entre 1 y 200 registros, con 50 por defecto. Envía cursor con el valor recibido hasta que nextCursor sea null. Pipelines, usuarios y el catálogo de campos devuelven listas sin este cursor.
Usa updatedSince para consultar cambios incrementales. Conserva los filtros al recorrer las páginas y guarda tu punto de sincronización después de procesarlas correctamente.

​
Idempotencia

En los POST, envía Idempotency-Key. Durante 24 horas, repetir la misma key con el mismo cuerpo devuelve la respuesta original y Idempotent-Replayed: true. No reutilices la key para otra operación o un cuerpo distinto: recibirás 422 idempotency_key_reused.

​
Campos personalizados

Consulta GET /custom-fields?entity=account|contact|opportunity. Cuentas, contactos y oportunidades aceptan y devuelven customFields.
Las claves del ejemplo son ilustrativas: usa las de tu catálogo. Los tipos disponibles son text, number, currency, date, list y multi_list. Envía fechas como YYYY-MM-DD; para moneda puedes enviar un número o { "amount": 1500, "currency": "USD" }. null borra el valor, sujeto a las validaciones del campo. Respeta los campos obligatorios y las opciones del catálogo.