---
title: "Start Group Batch Session"
method: POST
path: "/api/outreach/groups/batch"
tags: ["outreach", "outreach"]
---

# Start Group Batch Session

`POST /api/outreach/groups/batch`

## Request

- Base URL: `https://api.dialogbrain.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.dialogbrain.com/api/outreach/groups/batch`
- Auth: none declared

Start batch send to multiple groups.
Creates drafts or sends directly based on as_draft flag.

## Request body

- GroupBatchSendRequest: Request to start batch send to multiple groups.
  - `group_ids` integer[], required
  - `message_text` string, nullable
  - `prompt_context` string, nullable
  - `model` string
  - `temperature` number, nullable
  - `prompt_source` string, nullable
  - `as_draft` boolean
  - `personalize_per_group` boolean
  - `attachment_file_ids` integer[]

## Response `200`

Successful Response

- GroupBatchSessionResponse: Response for group batch operations.
  - `session` GroupBatchSession, required: Group batch session status.
    - `id` integer, required
    - `total_groups` integer, required
    - `processed_count` integer, required
    - `error_count` integer, required
    - `status` string, required
    - `started_at` string, nullable
    - `completed_at` string, nullable
    - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway.md) · [All operations](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/dialogbrain/apis/dialogbrain-v2-api-gateway/revisions/77bef09a9209?raw)