Crear automatización - Insurance Boosters API

POST

workflows

curl --request POST \
  --url https://api.insuranceboosters.com/api/v1/workflows \
  --header 'Content-Type: application/json' \
  --header 'x-ib-api-key: <api-key>' \
  --data '
{
  "name": "Notificar pago recibido",
  "trigger": {
    "type": "webhook"
  },
  "steps": [
    {
      "name": "Esperar",
      "actionKey": "system.delay",
      "input": {
        "mode": "duration",
        "amount": 1,
        "unit": "seconds"
      }
    },
    {
      "name": "Avisar sistema externo",
      "actionKey": "http.request",
      "input": {
        "method": "POST",
        "url": "https://ejemplo.com/hooks/pago",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "evento": "pago_recibido",
          "referencia": "{{trigger.body.referencia}}"
        }
      }
    }
  ]
}
'

{
  "id": "<string>",
  "name": "<string>",
  "status": "enabled",
  "trigger": {
    "type": "webhook",
    "secret": "<string>"
  },
  "steps": [
    {
      "actionKey": "browser.use",
      "task": "<string>",
      "resultSchema": {
        "type": "object"
      },
      "wait": {
        "initialDelaySeconds": 30,
        "pollIntervalSeconds": 15,
        "timeoutSeconds": 3600
      },
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "createdAt": 123,
  "lastUpdatedAt": 123,
  "publishedVersionId": "<string>",
  "latestVersionNumber": 123,
  "cronState": {
    "lastFiredAt": 123,
    "nextDueAt": 123
  }
}

{
  "error": "<string>"
}

{
  "message": "Invalid API key."
}

{
  "error": "<string>"
}

Crea una automatización en borrador. Para que acepte disparos debes publicarla y activarla.

Endpoint

POST /workflows

Body

Campo	Tipo	Requerido	Descripción
`name`	`string`	Sí	Nombre visible.
`status`	`string`	No	`enabled` o `disabled`. Recomendado: crear en `disabled`.
`trigger`	`object`	Sí	`webhook`, `cron`, `database_record_created` o `database_record_updated`.
`steps`	`array`	Sí	Uno o más pasos ordenados.

Trigger webhook

{ "type": "webhook" }

No envíes secret: la API lo genera y lo devuelve en la respuesta.

Trigger cron

{
  "type": "cron",
  "cron": "0 9 * * *",
  "timezone": "America/Mexico_City"
}

Trigger al crear un registro

{
  "type": "database_record_created",
  "databaseId": "<database-id>"
}

Se dispara automáticamente cuando se crea un registro en el tablero seleccionado.

Trigger al actualizar un registro

{
  "type": "database_record_updated",
  "databaseId": "<database-id>"
}

Se dispara automáticamente cuando cambian los campos o el alcance de un registro en el tablero seleccionado. Cambios que solo afectan otros metadatos no generan una ejecución. Obtén el databaseId con Listar tableros. Para ambos triggers puedes acceder al registro con {{trigger.body.record}}; sus campos están en {{trigger.body.record.values.<fieldId>}}.

Paso `browser.use`

{
  "actionKey": "browser.use",
  "task": "Investiga al prospecto {{trigger.body.record.values.<fieldId>}} y devuelve su sitio oficial, industria y fuentes.",
  "resultSchema": {
    "type": "object",
    "additionalProperties": false,
    "required": ["website", "industry", "sources"],
    "properties": {
      "website": { "type": "string" },
      "industry": { "type": "string" },
      "sources": {
        "type": "array",
        "items": { "type": "string" }
      }
    }
  },
  "wait": {
    "initialDelaySeconds": 30,
    "pollIntervalSeconds": 15,
    "timeoutSeconds": 3600
  }
}

Guía completa: Usar navegador.

Paso `system.delay`

{
  "name": "Esperar",
  "actionKey": "system.delay",
  "input": {
    "mode": "duration",
    "amount": 1,
    "unit": "seconds"
  }
}

Guía completa: Esperar.

Paso `http.request`

{
  "name": "Avisar sistema externo",
  "actionKey": "http.request",
  "input": {
    "method": "POST",
    "url": "https://ejemplo.com/hooks/pago",
    "headers": { "Content-Type": "application/json" },
    "body": {
      "referencia": "{{trigger.body.referencia}}"
    }
  }
}

Guía completa: Solicitud HTTP.

Paso `code.javascript`

{
  "name": "Normalizar referencia",
  "actionKey": "code.javascript",
  "input": {
    "referencia": "{{trigger.body.referencia}}"
  },
  "code": "output = { referencia: String(input.referencia || '').trim() };"
}

Guía completa (objetos disponibles, buenos/malos ejemplos): Paso JavaScript. Para pasar variables entre pasos (steps.N.output, capture, context) con ejemplos de 2 y 3 pasos, ver Variables y contexto.

Ejemplo de solicitud

curl -X POST "https://api.insuranceboosters.com/api/v1/workflows" \
  -H "Content-Type: application/json" \
  -H "x-ib-api-key: TU_API_KEY" \
  -d '{
    "name": "Notificar pago recibido",
    "status": "disabled",
    "trigger": { "type": "webhook" },
    "steps": [
      {
        "name": "Esperar",
        "actionKey": "system.delay",
        "input": { "mode": "duration", "amount": 1, "unit": "seconds" }
      },
      {
        "name": "Avisar sistema externo",
        "actionKey": "http.request",
        "input": {
          "method": "POST",
          "url": "https://ejemplo.com/hooks/pago",
          "headers": { "Content-Type": "application/json" },
          "body": {
            "evento": "pago_recibido",
            "referencia": "{{trigger.body.referencia}}"
          }
        }
      }
    ]
  }'

Respuesta exitosa (`201`)

{
  "id": "<workflow-id>",
  "name": "Notificar pago recibido",
  "status": "disabled",
  "trigger": {
    "type": "webhook",
    "secret": "<webhook-secret>"
  },
  "steps": [
    {
      "id": "<step-id>",
      "name": "Esperar",
      "actionKey": "system.delay",
      "input": {
        "mode": "duration",
        "amount": 1,
        "unit": "seconds"
      }
    }
  ],
  "latestVersionNumber": 0,
  "createdAt": 1720000000000,
  "lastUpdatedAt": 1720000000000
}

Guarda id y, si el trigger es webhook, trigger.secret para armar la URL pública.

Ejemplo con un registro actualizado

Este ejemplo envía el ID y el campo estado del registro actualizado a un sistema externo:

curl -X POST "https://api.insuranceboosters.com/api/v1/workflows" \
  -H "Content-Type: application/json" \
  -H "x-ib-api-key: TU_API_KEY" \
  -d '{
    "name": "Notificar cambio de estado",
    "status": "disabled",
    "trigger": {
      "type": "database_record_updated",
      "databaseId": "<database-id>"
    },
    "steps": [
      {
        "name": "Avisar sistema externo",
        "actionKey": "http.request",
        "input": {
          "method": "POST",
          "url": "https://ejemplo.com/hooks/estado",
          "headers": { "Content-Type": "application/json" },
          "body": {
            "recordId": "{{trigger.body.record.id}}",
            "estado": "{{trigger.body.record.values.estado}}"
          }
        }
      }
    ]
  }'

Publica y activa la automatización antes de actualizar el registro que debe dispararla.

Errores frecuentes

HTTP	Qué significa	Qué hacer
`400`	El body no cumple el esquema o el tablero no está disponible.	Revisa `trigger`, `databaseId`, `actionKey` y los campos requeridos por cada tipo de paso.
`401`	API key inválida o faltante.	Verifica `x-ib-api-key`.
`500`	No fue posible crear.	Reintenta; si continúa, contacta soporte.

Authorizations

x-ib-api-key

string

header

required

API key emitida por Insurance Boosters.

Body

application/json

name

string

required

trigger

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

steps

object[]

required

Minimum array length: 1

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

status

enum<string>

Available options:

enabled,

disabled

Response

Automatización creada en borrador.

string

required

name

string

required

status

enum<string>

required

Available options:

enabled,

disabled

trigger

object

required

Option 1
Option 2
Option 3
Option 4

Show child attributes

steps

object[]

required

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

createdAt

integer

required

lastUpdatedAt

integer

required

publishedVersionId

string

latestVersionNumber

integer

cronState

object

Show child attributes

curl --request POST \
  --url https://api.insuranceboosters.com/api/v1/workflows \
  --header 'Content-Type: application/json' \
  --header 'x-ib-api-key: <api-key>' \
  --data '
{
  "name": "Notificar pago recibido",
  "trigger": {
    "type": "webhook"
  },
  "steps": [
    {
      "name": "Esperar",
      "actionKey": "system.delay",
      "input": {
        "mode": "duration",
        "amount": 1,
        "unit": "seconds"
      }
    },
    {
      "name": "Avisar sistema externo",
      "actionKey": "http.request",
      "input": {
        "method": "POST",
        "url": "https://ejemplo.com/hooks/pago",
        "headers": {
          "Content-Type": "application/json"
        },
        "body": {
          "evento": "pago_recibido",
          "referencia": "{{trigger.body.referencia}}"
        }
      }
    }
  ]
}
'

{
  "id": "<string>",
  "name": "<string>",
  "status": "enabled",
  "trigger": {
    "type": "webhook",
    "secret": "<string>"
  },
  "steps": [
    {
      "actionKey": "browser.use",
      "task": "<string>",
      "resultSchema": {
        "type": "object"
      },
      "wait": {
        "initialDelaySeconds": 30,
        "pollIntervalSeconds": 15,
        "timeoutSeconds": 3600
      },
      "id": "<string>",
      "name": "<string>"
    }
  ],
  "createdAt": 123,
  "lastUpdatedAt": 123,
  "publishedVersionId": "<string>",
  "latestVersionNumber": 123,
  "cronState": {
    "lastFiredAt": 123,
    "nextDueAt": 123
  }
}

{
  "error": "<string>"
}

{
  "message": "Invalid API key."
}

{
  "error": "<string>"
}

​Endpoint

​Body

​Trigger webhook

​Trigger cron

​Trigger al crear un registro

​Trigger al actualizar un registro

​Paso browser.use

​Paso system.delay

​Paso http.request

​Paso code.javascript

​Ejemplo de solicitud

​Respuesta exitosa (201)

​Ejemplo con un registro actualizado

​Errores frecuentes

Authorizations

Body

Response

Endpoint

Body

Trigger webhook

Trigger cron

Trigger al crear un registro

Trigger al actualizar un registro

Paso `browser.use`

Paso `system.delay`

Paso `http.request`

Paso `code.javascript`

Ejemplo de solicitud

Respuesta exitosa (`201`)

Ejemplo con un registro actualizado

Errores frecuentes