Automate iBlueprint workflows: schedule, webhook, Slack

Triggers tell iBlueprint when to run a Blueprint. Instead of launching a Blueprint by hand every time, you can attach one or more triggers so the Blueprint fires automatically in response to external events, incoming messages, or a recurring schedule. iBlueprint supports six trigger types, and you can mix them on a single Blueprint.

Add a trigger

Open Blueprint triggers

Open your Blueprint, then click Triggers in the top toolbar or sidebar panel.

Click Add trigger

Choose a trigger type from the list.

Configure the trigger

Fill in the settings for that trigger type (see the sections below).

Activate

Toggle the trigger Active. iBlueprint saves the configuration and begins listening immediately.

You can also fire any trigger manually from the trigger detail panel — useful for testing before you go live.

Trigger types

A manual trigger has no automatic schedule or event. Use it to run a Blueprint on demand from the iBlueprint UI or by calling the fire endpoint from your own code.Configuration: none required.When to use: ad-hoc tasks, testing, or workflows that humans kick off after reviewing input data.

Runs the Blueprint on a cron schedule. iBlueprint uses standard five-field cron syntax.

┌───────── minute (0–59)
│ ┌───────── hour (0–23)
│ │ ┌───────── day of month (1–31)
│ │ │ ┌───────── month (1–12)
│ │ │ │ ┌───────── day of week (0–7, 0 and 7 = Sunday)
│ │ │ │ │
* * * * *

Common examples:

Expression	Meaning
`0 9 * * 1-5`	Every weekday at 9:00 AM
`/30 * * *`	Every 30 minutes
`0 0 1 * *`	First day of every month at midnight
`0 8,17 * * *`	Every day at 8:00 AM and 5:00 PM

When to use: daily reports, nightly data syncs, recurring reminders, or any workflow that should run on a predictable cadence.

iBlueprint generates a unique HTTPS URL for each webhook trigger. Any external system that sends a POST request to that URL will kick off the Blueprint, with the request body passed in as input data.Setup:

After saving the trigger, click Copy webhook URL to get the generated endpoint:
```
https://api.iblueprint.io/webhooks/blueprint/{trigger-id}
```
Paste this URL into the external system (GitHub Actions, Stripe, your own backend, etc.).
The external system sends a POST request with a JSON body whenever it needs to trigger the Blueprint.

Optional secret: if a secret is configured on the trigger, iBlueprint checks the X-Signature header on incoming requests for HMAC verification. Generate and store the secret in both iBlueprint and your sending system.When to use: responding to events from external services — deployments, payment confirmations, form submissions, IoT signals.

Fires the Blueprint when a specified Slack event occurs in a connected workspace.Configuration options:

Channel — the Slack channel ID or name to listen on.
Event type — for example, message, reaction_added, or app_mention.

Setup:

Connect your Slack workspace under Settings → Integrations → Slack if you have not already done so.
Select the channel and event type for this trigger.
Save the trigger. iBlueprint registers the event subscription with Slack automatically.

When to use: ChatOps workflows, monitoring Slack channels for keywords, responding to reactions, or letting team members trigger automations directly from Slack.

The API trigger exposes a named endpoint that you can call programmatically with a bearer token. Unlike a webhook, the API trigger is authenticated and intended for server-to-server calls from your own systems.Configuration options:

Endpoint name — a human-readable label for this trigger.
Input schema — optionally define the JSON fields your Blueprint expects as input.

Call the trigger endpoint using your iBlueprint API key:

curl -X POST https://api.iblueprint.io/v1/triggers/{trigger-id}/fire \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"userId": "u_123", "action": "welcome"}'

When to use: integrating Blueprint runs into your own application backend, CI/CD pipelines, or any server-side process that should not be exposed to unauthenticated webhooks.

Pass input data to a Blueprint

All trigger types (except manual) can pass structured data into the Blueprint at run time. This data is available to Blueprint nodes as the initial input payload. For webhook and API triggers you control the JSON body directly. For email and Slack triggers, iBlueprint normalizes the inbound message into a consistent schema that your Blueprint nodes can reference.

Deactivate or delete a trigger

Deactivate — toggle the trigger off. The configuration is preserved and iBlueprint stops listening. You can reactivate it at any time.
Delete — removes the trigger permanently. For webhook triggers, the generated URL stops accepting requests immediately.

​Add a trigger

​Trigger types

​Pass input data to a Blueprint

​Deactivate or delete a trigger

Add a trigger

Trigger types

Pass input data to a Blueprint

Deactivate or delete a trigger