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

# Bulk create subscribers

> Creates or updates subscribers in one bulk request.

`kit.bulkCreateSubscribers` creates or updates subscribers in one bulk request.

```ts automations/bulk-create-subscribers.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { kit } from "automate.ax/kit"

export default automation("Bulk create subscribers", () => {
  markSignificant(
    kit.bulkCreateSubscribers({
      subscribers: [{}],
    }),
  )
})
```

## Input

Pass these fields:

| Field         | Type             | Required | Description |
| ------------- | ---------------- | -------- | ----------- |
| `subscribers` | `object[]`       | Yes      | —           |
| `callbackUrl` | `string \| null` | No       | —           |

## Output

Returns an object with these fields:

| Field         | Type       | Required | Description |
| ------------- | ---------- | -------- | ----------- |
| `subscribers` | `object[]` | No       | —           |
| `failures`    | `object[]` | No       | —           |

> This action requires a Kit OAuth connection. Kit does not allow V4 API keys for this endpoint.

Kit may complete a small bulk request inline or return an asynchronous bulk job. Large queued jobs count against Kit's 300 MB account queue limit.

Kit rate limits OAuth connections to 600 requests per 60 seconds and V4 API keys to 120 requests per 60 seconds. Automate.ax honors provider retry timing for rate-limit and temporary bulk-capacity responses.