> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octavehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# What are Segments in Octave?

> Segments define target market groups by industry, company size, and other firmographics. Agents use them to tailor messaging and prioritize accounts.

## What is a Segment?

A Segment is a target market group defined by shared characteristics — industry vertical, company size, geography, technical maturity, or business model. Segments go beyond simple firmographic filters. They include segment-specific messaging guidance, priorities, and approaches that agents use to tailor outreach for each market. For example, your "Enterprise Healthcare" segment might emphasize compliance and data security, while your "Mid-market SaaS" segment leads with speed-to-value and integrations. Agents read these differences and adjust their output accordingly, so the same Sequence Agent produces different messaging for a hospital system than for a Series B startup. Without segments, agents treat every prospect the same. With them, your outreach reflects the specific language, priorities, and buying patterns of each market you serve.

## What a Segment contains

| Field                        | Purpose                                               |
| ---------------------------- | ----------------------------------------------------- |
| Name                         | Segment label (e.g., "Enterprise SaaS", "Healthcare") |
| Description                  | Overview of this market and why you target it         |
| Firmographic characteristics | Company size, industry, location, tech maturity       |
| Messaging guidance           | How to frame your value for this segment              |
| Priorities                   | What matters most to companies in this segment        |

## How Segments connect to other entities

* **[Use Cases](/concepts/use-cases)** — which problems are most common in this segment
* **[Motions](/concepts/motions)** — Motion Playbooks scope to one or more segments, and Motion ICPs are the persona×segment cells where messaging gets specific
* **[Buying Triggers](/concepts/buying-triggers)** — which signals are most common in this segment
* **Companies** (via [analytics](/concepts/analytics)) — companies automatically linked to segments based on fit scoring

When an agent qualifies a company, it determines which segment the company belongs to. That segment routes the agent to the right [Motion ICP](/concepts/motions#motion-icps) — which use cases to emphasize, which proof points to cite, and how to position the offering.

## Managing Segments via API

* `GET /api/v2/segment/list` — list all segments
* `GET /api/v2/segment/{id}` — get a specific segment
* `POST /api/v2/segment/create` — create a new segment
* `POST /api/v2/segment/generate` — AI-generate segments from your ICP and market context
* `PUT /api/v2/segment/update` — update an existing segment
* `DELETE /api/v2/segment/delete` — remove a segment