Skip to main content

Update Campaign Settings

Use this endpoint to update a campaign’s basic settings

L
Written by Lior Avidar
Updated over a week ago

This endpoint can update a campaign’s basic settings such as its name, default bid, or targeted countries. Ideal for advertisers needing quick adjustments without changing the full campaign structure.

Endpoint:
PUT /v1/external/campaigns/:campaignId

Required Header:
Authorization: Bearer YOUR_API_TOKEN


Path Parameter:

  • campaignId (Number) – The ID of the campaign to update

Request Body Example:

{
"data": {
"name": "Summer Promo 2025",
"bid": 2.5,
"countries": ["US", "CA"]
}
}

Validation Rules:

  • bid: Must be a float between 0–100

  • countries: Must be valid ISO 3166-1 alpha-2 country codes

  • name: Optional string, max 100 characters

Example Response:

{
"campaignId": 123456
}

Possible Errors:

  • 400campaign capped: Cannot update an active campaign with budget restrictions

  • 400invalid bid: Value exceeds allowed range (0–100)

  • 404not found: Campaign ID does not exist or was deleted

Did this answer your question?