> ## 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 sequence email

> Adds one email step to a sequence.

`kit.createSequenceEmail` adds one email step to a sequence.

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

export default automation("Create sequence email", () => {
  markSignificant(
    kit.createSequenceEmail({
      sequenceId: 1,
      subject: "value",
      delayValue: 1,
      delayUnit: "days",
    }),
  )
})
```

## Input

Pass these fields:

| Field             | Type                | Required | Description                                                                                                                                                          |
| ----------------- | ------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sequenceId`      | `integer`           | Yes      | —                                                                                                                                                                    |
| `subject`         | `string`            | Yes      | Subject line of the email                                                                                                                                            |
| `previewText`     | `string \| null`    | No       | Preview text shown in email clients before the email is opened                                                                                                       |
| `content`         | `string \| null`    | No       | HTML body content of the email                                                                                                                                       |
| `delayValue`      | `integer`           | Yes      | Number of days or hours to wait before sending this email after the previous one                                                                                     |
| `delayUnit`       | `"days" \| "hours"` | Yes      | Unit for the send delay. Use `days` for schedule-aware delivery, `hours` for a fixed hourly delay                                                                    |
| `emailTemplateId` | `integer \| null`   | No       | ID of the email template to use for layout and styling                                                                                                               |
| `published`       | `boolean`           | No       | Whether the email is active and will be sent to subscribers. Defaults to `false` (draft)                                                                             |
| `sendDays`        | `string[] \| null`  | No       | Days of the week this email may be sent. Defaults to all 7 days (inherits the sequence schedule). Pass a subset to restrict delivery, or `null` to reset to all days |
| `position`        | `integer \| null`   | No       | Zero-based position of the email in the sequence. Assigned automatically after the last email if omitted                                                             |

## Output

Returns an object with these fields:

| Field   | Type     | Required | Description |
| ------- | -------- | -------- | ----------- |
| `email` | `object` | Yes      | —           |

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.