Skip to main content

Update Segment Bid

Use this endpoint to update a segment's bid and targeting settings for a specific campaign.

Lior Avidar avatar
Written by Lior Avidar
Updated yesterday

Endpoint:
PUT /external/:campaignId/segments/:segmentId


Required Header:
Authorization: Bearer YOUR_API_TOKEN


Path Parameters:

  • campaignId (Number, Required) – The ID of the campaign.

  • segmentId (Number, Required) – The ID of the segment within the campaign to update.


Request Body Example:

{ 
"name": "High Value Android",
"bid": 2.3,
"countries": ["US", "CA"]
}

Field Requirements:

  • name (string) – The new name of the segment (optional).

  • bid (float) – The new bid value (must be > 0 and between 0–100).

  • countries (array of strings) – The list of targeted countries (using ISO 3166-1 alpha-2 codes).


Example Response:

{
"segmentId": 98765
}

Validation Rules:

  • Segment must belong to the specified campaign.

  • Segment bid must be higher than the campaign's default bid.


Possible Errors:

  • 403 – unauthorized: Missing or invalid permissions.

  • 404 – not found: Segment or campaign does not exist.

Did this answer your question?