# Webhooks & events

> Receive real-time event notifications from Dailybot via webhooks. Subscribe to check-in, form, kudos, and organization events.

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

---

# Webhooks & Events

Dailybot webhooks let your application receive real-time HTTP notifications when events occur in your organization. Instead of polling the API, you register a URL that Dailybot calls whenever subscribed events happen.

## Subscribing to events

To set up an outgoing webhook, you need to configure three things:

1. **URL** — The endpoint that will receive event payloads
2. **Event subscriptions** — Which event types to listen for
3. **Object subscriptions** — Specific check-ins or forms to filter (optional, not required for all events)

Configure webhooks via the [web interface](https://app.dailybot.com/settings/integrations), the [Webhooks API](/developers/api/webhooks), or through [Zapier](/connections/zapier).

## Supported events

### Check-in events

| Event | Description |
|-------|-------------|
| `followups.response.completed` | Triggered when a member completes a check-in response |
| `followups.response.updated` | Triggered when a check-in response is modified |
| `followups.response.deleted` | Triggered when a check-in response is deleted |

### Form events

| Event | Description |
|-------|-------------|
| `forms.response.created` | Triggered when a form response is submitted |
| `forms.response.updated` | Triggered when a form response is edited |
| `forms.response.deleted` | Triggered when a form response is removed |

### Kudos events

| Event | Description |
|-------|-------------|
| `kudos.posted` | Triggered when kudos are given to an organization member |

### Organization events

| Event | Description |
|-------|-------------|
| `organization.user_activated` | Triggered when an admin activates a user |
| `organization.user_deactivated` | Triggered when a user is deactivated |
| `organization.team_user_added` | Triggered when a user is added to a team |
| `organization.team_user_removed` | Triggered when a user is removed from a team |

> **Privacy:** All events respect privacy settings. Anonymous check-in responses exclude user information, and events are not sent if subscribers lack read permissions.

## Event payload structure

All webhook events follow this standard structure:

```json
{
  "event": "followups.response.completed",
  "event_timestamp": "2026-02-14T09:15:00Z",
  "hook": {
    "id": "wh-1234-abcd",
    "name": "Check-in Responses"
  },
  "body": {
    "...": "Event-specific payload data"
  }
}
```

## Authentication

Dailybot supports three methods to secure your webhook endpoint:

### Secret signature

Dailybot sends an `X-BEARER` header with a configurable bearer token. Set this when creating the webhook subscription and validate it in your endpoint.

```javascript
// Verify the webhook signature
const signature = req.headers['x-bearer'];
if (signature !== process.env.DAILYBOT_WEBHOOK_SECRET) {
  return res.status(401).json({ error: 'Invalid signature' });
}
```

### HTTPS basic authentication

Embed credentials directly in the webhook URL:

```
https://username:password@your-app.com/webhooks/dailybot
```

### OAuth 2.0 authentication

Provide an authorization access URL and optional private auth key. Dailybot will obtain tokens from your OAuth provider and include them in webhook requests.

## Managing webhooks

Create and manage webhooks through:

- **Web Interface** — Navigate to [Organization Settings → Integrations](https://app.dailybot.com/settings/integrations)
- **API** — Use the [Webhooks API endpoints](/developers/api/webhooks) for programmatic management
- **Zapier** — Connect Dailybot events to 5,000+ apps via [Zapier integration](/connections/zapier)

## Testing webhooks

- Use the `immediate_sample_event` parameter when creating a webhook to receive a test event immediately
- Use tools like [webhook.site](https://webhook.site) or [ngrok](https://ngrok.com) for local development
- Log all incoming payloads during development for debugging
- Return a `200 OK` response quickly — process events asynchronously

---

## 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) (this page)
- [Automation API trigger](/developers/workflow-trigger)
- [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)