> This page is for version FRAML API (default).
> For other versions, use one of these documentation indexes:
> - FRAML API (default): https://docs.flagright.com/framl-api/llms.txt
> - Management API: https://docs.flagright.com/management-api/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.flagright.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.flagright.com/_mcp/server.

# Batch Completed

POST 

Occurs whenever a batch is completed

Reference: https://docs.flagright.com/api-reference/webhooks/batch/batch-completed

## Request

### Headers

- `x-flagright-signature` (string, required) — An [HMAC SHA256 signature](/guides/webhooks/signatures#verifying-signatures) generated using the webhook payload and a shared signing secret. This is then converted to a hex encoded string.

### Payload

- `id` (string, required) — Unique identifier for the event
- `triggeredBy` (enum, required) — Event triggered by a user or system
  - Allowed values: `MANUAL`, `SYSTEM`
- `createdTimestamp` (double, required) — Time at which the event was created. Measured in ms since the Unix epoch.
- `type` (enum, required)
  - Allowed values: `BATCH_COMPLETED`
- `data` (BatchCompletedDetails, required) — Payload sent when a batch import is fully processed
- `account` (string, optional) — Email ID associated with the event

## Types

### BatchCompletedDetails

Payload sent when a batch import is fully processed

- `batchId` (string, required) — Unique identifier of the batch
- `type` (enum, required) — Type of batch entity
  - Allowed values: `TRANSACTION_BATCH`, `TRANSACTION_EVENT_BATCH`, `USER_BATCH`, `USER_EVENT_BATCH`
- `totalCount` (integer, required) — Total number of successfully validated records in the batch
- `processedCount` (integer, required) — Number of records that were processed
- `status` (enum, required)
  - Allowed values: `COMPLETED`
- `createdAt` (integer, required) — Timestamp when the batch was created (in milliseconds)
- `completedAt` (integer, required) — Timestamp when the batch was completed (in milliseconds)
- `userType` (enum, optional)
  - Allowed values: `BUSINESS`, `CONSUMER`