# Activity API

> Push custom activity from external apps into Dailybot check-in reports via the Activity Hook URL.

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

---

The Activity API lets you push custom activity from any external application into Dailybot. Use it to track work from tools that don't have a native Dailybot integration — activity appears in check-in reports alongside data from other integrations.

> **Info:** Get your hook URL from [Settings → API & integrations → Activity API](https://app.dailybot.com/settings/integrations).

> **Billing requirement:** Your organization must have a billing plan that supports APIs and integrations to use the Activity API.

<h2 id="getting-started">Getting started</h2>

1. Go to Settings → Integrations → **Activity API**
2. Copy your unique **Activity Hook URL**
3. Send POST requests to that URL from your application

<h2 id="post-request">POST request</h2>

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

<h3 id="request-fields">Request fields</h3>

- `custom_type` (required) — Activity identifier, max 128 characters
- `message` (required) — Activity text shown in the report
- `link` (optional) — Clickable URL in reports
- `user_email` or `user_uuid` (one required) — User attribution

```bash
curl -X POST "https://your-activity-hook-url/" \
  -H "Content-Type: application/json" \
  -d '{
    "custom_type": "deployment",
    "message": "Deployed v2.1.0 to production",
    "link": "https://github.com/org/repo/releases/tag/v2.1.0",
    "user_email": "developer@company.com"
  }'
```

<h2 id="response-codes">Response codes</h2>

- `200` — Activity recorded successfully
- `404` — User email or UUID not found in the organization

<h2 id="activity-tracking">Activity tracking in reports</h2>

Enable **Activity tracking** in check-in Settings → Sharing → Advanced Options. Activity logged within 24 hours before a check-in response appears as an automatic column in reports.

<h2 id="use-cases">Use cases</h2>

- Deployments and CI/CD events
- Support tickets resolved per team member
- Custom scripts and internal tooling
- [Zapier](/connections/zapier) or Make using the hook URL as a webhook destination

---

## 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)
- [Activity API](/developers/activity-api) (this page)

**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)