> ## 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.

# Create subscription

> Creates a filtered ad-account event subscription.

`metaAds.createSubscription` creates a filtered ad-account event subscription.

```ts automations/meta-ads-create-subscription.automation.ts theme={null}
import { automation, onDashboardRun } from "automate.ax"
import { metaAds } from "automate.ax/meta-ads"

export default automation("Create subscription", () => {
  onDashboardRun({ title: "Create subscription" })
  const result = metaAds.createSubscription({
    adAccountId: "123456789",
    eventType: "INSIGHTS_MILESTONE_REACHED",
    field: "spent",
    value: "10000",
    operator: "EQUAL",
    filters: [
      { field: "entity_type", operator: "EQUAL", value: "CAMPAIGN" },
      { field: "time_preset", operator: "EQUAL", value: "LIFETIME" },
    ],
  })
  // Use result in the next advertising, reporting, or delivery operation.
})
```

Meta permits campaign, ad-set, ad, and insights events with at most 20 filters. Insights subscriptions require a `time_preset` filter with an uppercase provider value such as `LIFETIME`, `TODAY`, or `LAST_7_DAYS`. Monetary values use minor units. Optional second argument `{ account }` selects a static project account binding.

Returns `{ subscriptionId }`. Creation is not replay-safe.