---
title: "Create a statement schedule for a workflow"
method: POST
path: "/v2/outreach-workflows/{workflow_id}/statement-schedule"
tags: ["outreach-workflows"]
---

# Create a statement schedule for a workflow

`POST /v2/outreach-workflows/{workflow_id}/statement-schedule`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/outreach-workflows/{workflow_id}/statement-schedule`
- Auth: HTTP bearer

The schedule controls when recurring account statements are sent for
partners on the workflow.

## Path parameters

- `workflow_id` string, required

## Request body

- CreateStatementScheduleRequest
  - `frequency` 'weekly' | 'biweekly' | 'monthly', required
  - `day_of_week` integer, nullable
  - `day_of_month` integer, nullable
  - `week_of_month` integer, nullable
  - `email_template` string, required: Email template ID
  - `auto_send` boolean
  - `attach_xls` boolean
  - `include_credit_memos` boolean
  - `include_disputed_items` boolean
  - `cc` string[]
  - `bcc` string[]
  - `cc_secondary_contacts` boolean
  - `external_roles_to_cc` ExternalContactType[]
  - `internal_roles_to_cc` InternalContactType[]

## Response `200`

Successful Response

- AccountStatementScheduleResponse
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `is_active` boolean, required
  - `frequency` 'weekly' | 'biweekly' | 'monthly', required
  - `day_of_week` integer, nullable, required: Day of week (0=Monday, 6=Sunday). Required for WEEKLY/BIWEEKLY.
  - `day_of_month` integer, nullable, required: Day of month (1-31). Required for MONTHLY day-of-month mode. Falls back to last day if month is shorter.
  - `week_of_month` integer, nullable, required: Week occurrence (1-5, where 5=last). Used with day_of_week for monthly day-of-week mode.
  - `biweekly_anchor_date` string, date, nullable, required: Anchor date for biweekly cadence calculation. Required for BIWEEKLY.
  - `include_credit_memos` boolean, required
  - `include_disputed_items` boolean, required
  - `auto_send` boolean, required
  - `attach_xls` boolean, required: If True, always attach an XLS to the scheduled statement, ignoring partner.is_xls_attachments_enabled.
  - `cc` string[], nullable, required
  - `bcc` string[], nullable, required
  - `cc_secondary_contacts` boolean, required
  - `external_roles_to_cc` string[], nullable, required
  - `internal_roles_to_cc` string[], nullable, required
  - `email_template` EmailTemplateSummary, required
    - `id` string, required
    - `name` string, required
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/ff0ad16a55ff?raw)