---
title: "POST /v1/workspaces/{workspaceId}/segments"
method: POST
path: "/v1/workspaces/{workspaceId}/segments"
---

# POST /v1/workspaces/{workspaceId}/segments

`POST /v1/workspaces/{workspaceId}/segments`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/segments`
- Auth: HTTP bearer

## Request body

- object
  - `name` string, required
  - `filter` ContactFilter: Conditions must reference declared contact fields and use operators supported by their type. set and not_set omit value; within_days uses 1–3650 days.
    - `status` 'subscribed' | 'unsubscribed' | 'bounced' | 'complained'
    - `attributes` object
    - `conditions` object[]
      - `field` string, required
      - `op` 'is' | 'is_not' | 'contains' | 'set' | 'not_set' | 'gt' | 'gte' | 'lt' | 'lte' | 'within_days' | 'any_of' | 'includes', required
      - `value` union
        - string
        - number
        - boolean
        - string[]
    - `match` 'all' | 'any'

## Response `201`

Successful response.

- object
  - `data` ContactSegment, required
    - `id` string, uuid, required
    - `name` string, required
    - `filter` ContactFilter, required: Conditions must reference declared contact fields and use operators supported by their type. set and not_set omit value; within_days uses 1–3650 days.
      - `status` 'subscribed' | 'unsubscribed' | 'bounced' | 'complained'
      - `attributes` object
      - `conditions` object[]
        - `field` string, required
        - `op` 'is' | 'is_not' | 'contains' | 'set' | 'not_set' | 'gt' | 'gte' | 'lt' | 'lte' | 'within_days' | 'any_of' | 'includes', required
        - `value` union
          - string
          - number
          - boolean
          - string[]
      - `match` 'all' | 'any'
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/0705eb6ef2bc?raw)