Why Update an Ad?

Sometimes, you may find it necessary to update an existing ad that is part of a flight or campaign. This may be needed if you want to use new graphics or images, or just make changes to the ad as part of an update to a flight or campaign. The Kevel API lets you make those updates simply and easily by using the Update Ad API call.

📘

Note

You can update all fields from Create Ads except for id.

❗️

Warning

Do not use this endpoint to update creatives from the Create Creatives endpoint. This API call is used to update ads from the Create Ads endpoint.

Also, any fields you do not include in a PUT request will be given the default values null, false, 0, or empty array, depending on the field. This will overwrite any existing values. When making a PUT request, make sure you are supplying all the fields that should have values.

API Syntax

When using the Update Ad API, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

PUT https://api.kevel.co/v1/flight/{FlightID}/creative/{AdID}

Where:

• PUT - the type of API request being made.
• https://api.kevel.co - the URL for the request.
• v1 - the API version.
• flight - the API endpoint being called.
• FlightID - the ID associated with the flight.
• creative - the creative associated with the Ad.
• AdID - the ID of the ad being updated.

Category Targeting

Send CategoryTargeting to set explicit category rules on the Ad, or "CategoryTargeting": null to make the Ad use its Flight’s rules again. A non-empty list replaces the Flight’s complete list. For the rule format, see Create Ads.