---
title: "Create segmentation"
method: POST
path: "/v2/segmentation"
tags: ["Segmentation"]
---

# Create segmentation

`POST /v2/segmentation`

Create a new segmentation from a list of company domains. Runs asynchronously — poll [Get Segmentation](/docs/getSegmentation) until `status` is `SUCCESSFUL` to read the resulting segments.

## Query parameters

- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Request body

- SegmentationInput
  - `domains` string[], required — Company domains to segment. Provide a representative set of the companies you want to group, typically your customers or best-fit accounts.
  - `leadScoringFeatures` string[], nullable — Company attributes to consider when grouping and scoring companies (for example `industries`, `technologies`, `company_size`). Omit to use the default feature set.
  - `numberOfSegmentsMode` integer, nullable — Bias toward fewer or more segments. Omit to let the service choose the number that best fits the data.
  - `positiveDomains` string[], nullable — Companies that are a good fit. The segmentation leans toward similar companies.
  - `negativeDomains` string[], nullable — Companies that are a poor fit. The segmentation leans away from similar companies.

## Response `200`

Successful Response

- SegmentationId
  - `segmentationId` integer, required — Unique id of the segmentation. Use it to poll for results with the get segmentation endpoint.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ocean/ocean-io-api-documentation/revisions/505121e48722/schema)