Create a segment category

post

https://{buzz_key}.api.beeswax.com/rest/v2/segment-categories

Creates a new segment category with the provided attributes. Segment categories organize segments hierarchically and can have parent-child relationships.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

account_id

integer

required

Defaults to the account in the active session

advertiser_id

integer | null

required

The advertiser that owns the segment category. Pass null for none.

parent_key

string | null

required

Alphanumeric key for the parent node in the tree. Pass null for a top-level category.

name

string

required

length ≤ 191

The descriptive name of the segments. This field cannot be blank.

active

boolean

Defaults to true

Whether the segment category is active.

alternative_id

string | null

An ID that may be used for any reporting or administrative purpose. Limited to 191 characters.

notes

string | null

Free-form notes of up to 255 characters.

Headers

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

400

Validation error or invalid parameters.

401

Authentication credentials were not provided.

403

Permission denied.

201Segment category created successfully.