# Automation API trigger

> Trigger Dailybot workflows by sending JSON events to a unique URL. Build event-driven automations with custom data.

Language: en
Canonical: https://www.dailybot.com/developers/workflow-trigger
Markdown: send header `Accept: text/markdown` on any URL to receive Markdown instead of HTML.
Last Updated: 2026-04-06

---

# Workflow API trigger

The Workflow API Trigger lets you send any JSON event to Dailybot to start a workflow. Use it to broadcast system events as channel notifications, trigger post-checkin actions, or build event-driven automations.

> **Beta feature:** The Workflow API Trigger is currently in **beta**. If you're interested in using it, please [contact the Dailybot team](https://app.dailybot.com/forms/86a5b53f-8bc9-4b84-b78f-7c51b805d674/responses/create).

## How it works

1. You send a POST request with a JSON payload to your unique trigger URL
2. Dailybot matches the `event_type` in the payload against your configured workflows
3. Matching workflows are executed with access to the event data
4. Dailybot responds with HTTP 200 regardless of whether a matching workflow exists

> Dailybot does not store these events. They are only processed to decide which workflow to trigger and then discarded.

## Setting up

1. Navigate to [Dailybot Settings → Integrations](https://app.dailybot.com/settings/integrations)
2. Select **Workflow Trigger**
3. Copy your unique triggering URL
4. Send POST requests with JSON event data to this URL
5. Create corresponding workflows in Dailybot that listen for your event types

## The POST request

Send a POST request with `Content-Type: application/json` to your trigger URL.

### Required fields

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_type` | string | Yes | A custom identifier string for the event (e.g. `"log_revenue"`, `"deploy_complete"`). Used to match workflows. |
| `secret` | string | No | Optional secret for signature verification. If configured and mismatched, the workflow will not trigger. |

You can include any additional custom JSON data beyond these fields:

```bash
curl -X POST "https://api.dailybot.com/workflow-trigger/your-unique-id/" \
  -H "Content-Type: application/json" \
  -d '{
    "event_type": "deploy_complete",
    "secret": "your-secret-token",
    "service": "api-gateway",
    "version": "2.1.0",
    "environment": "production",
    "deployed_by": "CI/CD Pipeline"
  }'
```

## Creating workflows

To create a workflow that responds to your API triggers:

1. Go to **ChatOps** in the Dailybot web app
2. Navigate to **Workflows**
3. Create a new workflow and select **API Trigger** as the trigger type
4. Set the `event_type` to match your POST request
5. Configure the workflow actions (send message, run command, etc.)

## Use cases

- **Deployment notifications** — Broadcast deploy events to a `#releases` channel
- **Payment alerts** — Route payment events to `#revenue` with amount details
- **Support escalation** — Send critical support tickets to the on-call team
- **Post-checkin actions** — Trigger manager follow-ups or surveys after check-in completion
- **Form processing** — Notify specific users when forms are submitted with certain criteria
- **CI/CD integration** — Send build results as team notifications

---

## Developer portal navigation

**Getting Started**

- [Overview](/developers)
- [Quick start](/developers/getting-started)
- [Authentication](/developers/authentication)

**API Reference**

- [API Overview](/developers/api)
- [Users](/developers/api/users)
- [Organization](/developers/api/organization)
- [Teams](/developers/api/teams)
- [Invitations](/developers/api/invitations)
- [Check-ins](/developers/api/check-ins)
- [Forms](/developers/api/forms)
- [Report channels](/developers/api/report-channels)
- [Templates](/developers/api/templates)
- [Kudos](/developers/api/kudos)
- [Mood tracking](/developers/api/mood)
- [Important dates](/developers/api/important-dates)
- [Messaging](/developers/api/messaging)
- [Automations](/developers/api/workflows)
- [Webhooks](/developers/api/webhooks)
- [Commands platform](/developers/api/commands-platform)
- [Agents](/developers/api/agents)
- [OAuth2](/developers/api/oauth2)
- [Integrations](/developers/api/integrations)
- [CLI](/developers/api/cli)

**API guides**

- [Errors & Status Codes](/developers/errors)
- [Rate Limits](/developers/rate-limits)
- [Conventions](/developers/conventions)
- [API Changelog](/developers/api-changelog)
- [Recipes](/developers/recipes)

**Developer Features**

- [Custom commands](/developers/custom-commands)
- [Serverless commands](/developers/serverless)
- [Webhooks & events](/developers/webhooks)
- [Automation API trigger](/developers/workflow-trigger) (this page)
- [Activity API](/developers/activity-api)

**CLI**

- [Overview](/developers/cli)
- [Authentication](/developers/cli-authentication)
- [Command reference](/developers/cli-reference)
- [CI/CD recipes](/developers/cli-ci-cd)
- [Configuration](/developers/cli-configuration)
- [Troubleshooting](/developers/cli-troubleshooting)

**Agent Skill**

- [Overview](/developers/agent-skill)
- [Skills catalog](/skills)

---

## Site navigation

**Product:**
- [Home](/)
- [Product](/product)
- [Pricing](/pricing)
- [Enterprise](/enterprise)
- [Integrations](/integrations)
- [Templates](/templates)

**Resources:**
- [Blog](/blog)
- [Academy](/academy)
- [Changelog](/changelog)
- [Help Center](/help)
- [Developers](/developers)
- [Agents](/agents)

**Company:**
- [About](/about)
- [Careers](/careers)
- [Security](/security)
- [Contact Sales](/demo)

**Connect:**
- [LinkedIn](https://www.linkedin.com/company/dailybot/)
- [X/Twitter](https://twitter.com/dailybot)
- [GitHub](https://github.com/Dailybot-Inc)
- [YouTube](https://www.youtube.com/channel/UC3uM9V52vwX7e3vQpCc4qvA)