# AdvertiserId

int32

required

The ID of the Advertiser.

# SegmentId

int32

required

The ID of the Segment.

# 200 Response from the Create Advertiser Segment endpoint.

object

## Id

int32

required

Defaults to 0

The ID of the Advertiser Segment.

## AdvertiserId

int32

required

Defaults to 0

The ID of the Advertiser.

## SegmentId

int32

required

Defaults to 0

The ID of the Segment.

## Segment

object

required

### Id

int32

required

Defaults to 0

The ID of the Segment.

### Source

string

Where the Segment came from.

### Name

string

required

The human-friendly name of the Segment.

### Reach

object

The estimated reach of the segment for all time and the last 4 weeks.

#### Reach object

##### Description

string

An extended human-friendly description of the Segment.

##### Category

string

The Category a Segment belongs to.

# 400 An error signifying that the client has issued a bad request

---

## ShellJavaScriptRuby

```

xxxxxxxxxx

curl -X POST -H "X-Adzerk-ApiKey:<APIKEY>" -H "Content-Type:application/json" https://api.kevel.co/v1/advertiser/{AdvertiserId}/segment --data-binary '{"AdvertiserId":111111,"SegmentId":222222}'

```

```

xxxxxxxxxx

{

"Id": 56789,

"AdvertiserId": 111111,

"SegmentId": 222222,

"Segment": {

"Id": 222222,

"Source": "audience",

"Name": "best customers",

"Reach": {

"all_time": 3187463,

"28d": 387434

},

"Description": "top 1% spenders in the last 30 days.",

"Category": "CRM"

}

}

---