Automatizaciones

Listar y administrar el estado de tus automatizaciones de Finova. En Fase 1 puedes leer, renombrar, pausar/activar y eliminar — pero no crear desde cero, porque el schema de triggers y pasos está evolucionando y todavía no es contrato público.

El objeto Automation

{
  "id":           "65a7c8d9e0f1234567890abc",
  "name":         "Enviar bienvenida a nuevos clientes",
  "description":  "Cuando se crea un cliente, espera 1 hora y envía un email.",
  "active":       true,
  "trigger_type": "customer_created",
  "steps_count":  3,
  "created_at":   "2026-03-01T10:00:00Z",
  "updated_at":   "2026-05-10T22:14:55Z"
}

Campos

Campo	Tipo	Descripción
id	string	ObjectId.
name	string	Nombre humano.
description	string	Descripción libre.
active	bool	Si la automatización está ejecutándose.
trigger_type	string	Tipo de evento que la dispara (customer_created, lead_created, etc.). Read-only.
steps_count	integer	Cantidad de pasos configurados. Read-only.
created_at / updated_at	string	ISO 8601 UTC.

Schemas evolutivos

trigger_config y la lista completa de steps NO se exponen en el API público de Fase 1. Si tu integración necesita inspeccionarlos, dinos para priorizar — pero ten en cuenta que esos schemas pueden cambiar.

---

Listar automatizaciones

GET/api/v1/automationsread-automations

Query params: page, limit.

cURL

curl 'https://developers.fi-nova.com/api/v1/automations' \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO'

---

Obtener una automatización

GET/api/v1/automations/:idread-automations

---

Crear (no soportado en Fase 1)

POST/api/v1/automationscreate-automations

Devuelve 422 not_supported_yet:

{
  "error": "not_supported_yet",
  "message": "Creating automations via API will be supported in a future version. For now, create automations from the Finova UI and toggle/edit them via API."
}

Crea tus automatizaciones desde la UI de Finova y luego usa esta API para administrar su estado.

---

Actualizar una automatización

PATCH/api/v1/automations/:idupdate-automations

Campos aceptados en data: name, description, active.

Los campos trigger_type, trigger_config y steps NO se pueden modificar por API en Fase 1 — vienen ignorados aunque los mandes.

Caso de uso típico: pausar/activar masivamente.

cURL

# Pausar
curl -X PATCH https://developers.fi-nova.com/api/v1/automations/65a7c8d9e0f1234567890abc \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO' \
  -H 'Content-Type: application/json' \
  -d '{ "data": { "active": false } }'

# Renombrar
curl -X PATCH https://developers.fi-nova.com/api/v1/automations/65a7c8d9e0f1234567890abc \
  -H 'Authorization: Bearer finova_sk_TU_SECRETO' \
  -H 'Content-Type: application/json' \
  -d '{ "data": { "name": "Bienvenida v2" } }'

JavaScript

await fetch(`https://developers.fi-nova.com/api/v1/automations/${id}`, {
  method: 'PATCH',
  headers: {
    Authorization: 'Bearer finova_sk_TU_SECRETO',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ data: { active: false } }),
});

---

Eliminar una automatización

DELETE/api/v1/automations/:iddelete-automations

204 No Content. Operación destructiva e irreversible: los pasos embebidos y la configuración se pierden. Considera setear active: false en lugar de eliminar si solo quieres pausar.

---

Errores específicos

error	Cuándo
not_supported_yet (422)	Trataste de crear una automatización via API en Fase 1.
validation_failed (422)	Datos inválidos en update.
not_found (404)	El id no existe o pertenece a otra empresa.
insufficient_scope (403)	Falta el scope.