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 enables you to 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 valuesnull
,false
,0
, orempty array
, depending on the field. This will overwrite any existing values. When making aPUT
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.
Clearing attribute values
To unset or clear an attribute, set its value to
NULL
.