> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# On subscriber tag added

> Subscribes when a tag is added to a subscriber.

`kit.onSubscriberTagAdded` subscribes when a tag is added to a subscriber.

```ts automations/on-subscriber-tag-added.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { kit } from "automate.ax/kit"

export default automation("On subscriber tag added", () => {
  const event = kit.onSubscriberTagAdded()
  markSignificant(event)
})
```

## Event

| Field     | Type                     | Required | Description                                     |
| --------- | ------------------------ | -------- | ----------------------------------------------- |
| `id`      | `string (UUID)`          | Yes      | Stable event identifier used for deduplication. |
| `type`    | `"subscriber.tag_added"` | Yes      | Kit provider event type.                        |
| `created` | `string (date-time)`     | Yes      | When the event occurred.                        |
| `data`    | `object`                 | Yes      | Provider payload for this event.                |

`data` contains `subscriber` and `tag`. Provider snake case fields are exposed as camelCase. Subscriber custom-field keys under `fields` are preserved exactly.

Automate.ax creates and maintains one account-level Kit webhook endpoint, verifies the timestamped `X-Kit-Signature` against the raw body, and deduplicates each event by `id`. Kit can batch up to 100 same-type events in one delivery; each event starts independently. Use `kit.onEvent` when one automation should receive every available event.
