Primeros pasos

La API conecta tu backend con los contactos, audiencias, eventos y envíos de un workspace. Usa los mismos controles de permisos, consentimiento y capacidad que el dashboard.

Prepara la conexión

1. Obtén el identificador del workspace en Configuración → Workspace.
2. Un propietario o administrador debe crear una integración y emitir una clave desde Desarrolladores.
3. Guarda el secreto en el servidor y concede solo los permisos necesarios.
4. Obtén del operador la URL base del servicio API de tu entorno.

En los ejemplos, SENDIRO_API_BASE es esa URL base, sin /v1 ni barra final; SENDIRO_WORKSPACE_ID y SENDIRO_API_KEY son valores de tu entorno. Las rutas de integración empiezan por /v1/workspaces/{workspaceId}.

Comprueba el acceso

Con contacts:read, consulta una primera página:

curl "$SENDIRO_API_BASE/v1/workspaces/$SENDIRO_WORKSPACE_ID/contacts?limit=10" \
  -H "Authorization: Bearer $SENDIRO_API_KEY"

La respuesta incluye data, nextCursor y requestId. Continúa usando el cursor devuelto hasta que sea null. Consulta convenciones antes de implementar escrituras.

Elige la operación

• Contactos: crear perfiles, sincronizar por email, importar y gestionar consentimiento.
• Campos personalizados y audiencias: definir datos y agrupaciones.
• Envío de email: aceptar un mensaje y consultar su progreso.
• Eventos, analítica y webhooks: activar recorridos y observar resultados.

Las claves no administran diseños, difusiones, automatizaciones, miembros ni facturación. Prepara esos recursos en el dashboard. Un permiso válido tampoco habilita un transporte sin configurar ni evita las cuotas del producto.