---
title: "Bulk Categorize Leads"
method: POST
path: "/v1/organizations/organization/bulk-categorize"
tags: ["Organisations"]
---

# Bulk Categorize Leads

`POST /v1/organizations/organization/bulk-categorize`

## Request

- Base URL: `https://client.api.prod.orsay.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://client.api.prod.orsay.ai/v1/organizations/organization/bulk-categorize`
- Auth: HTTP bearer

Bulk categorize existing leads based on CSV data and rules.

## Request body

- BulkCategorizeRequest
  - `username_column` string, required
  - `rules` BulkCategorizeRule[], required
    - `column` string, required
    - `operator` string, required
    - `value` string, required
    - `classification_id` string, required
  - `rows` object[], required

## Response `200`

Successful Response

- BulkCategorizeResponse
  - `total_rows` integer, required
  - `matched` integer, required
  - `not_found` integer, required
  - `categorized` object, required

## Other responses

- `422`: Validation Error

---

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