---
title: "Create a Segment Group"
method: POST
path: "/segment_groups"
tags: ["Segment Groups"]
---

# Create a Segment Group

`POST /segment_groups`

## Request

- Base URL: `https://api.mediamath.com/api/v3.0`
- URL: `https://api.mediamath.com/api/v3.0/segment_groups`
- Auth: OAuth 2
  - Authorization code: `https://auth.mediamath.com/authorize`
  - Token URL: `https://auth.mediamath.com/oauth/token` scopes: `offline_access`, `manage:services`
- TypeScript: <https://skmtc.dev/mediamath/apis/campaigns-api/docs/segment_groups/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a segment group

## Request body

- SegmentGroupCreate
  - `name` string, required
  - `type` 'CONTEXTUAL' | 'AUDIENCE', required
  - `organization_id` integer, required
  - `status` boolean, required
  - `segment_subgroup` object[], required
    - `segment_operator` 'AND' | 'OR', required
    - `segment_members` object[], required
      - `segment_id` integer, required
      - `segment_type` 'CONTEXTUAL' | '3P', required

## Response `201`

Audience group response

- object
  - `data` object
    - `name` string
    - `type` string
    - `organization_id` integer
    - `status` boolean
    - `segment_subgroup` object[]
      - `segment_operator` string
      - `segment_members` object[]
        - `segment_id` integer
        - `segment_type` 'CONTEXTUAL' | '3P'
  - `meta` SingleMetadata
    - `status` string, required

## Other responses

- `400`: Error response
- `401`: Error response
- `403`: Error response
- `404`: Error response

---

[API](https://skmtc.dev/mediamath/apis/campaigns-api.md) - [All operations](https://skmtc.dev/mediamath/apis/campaigns-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mediamath/apis/campaigns-api/revisions/408743891def?raw)