How to use API to upload image creatives

[Fences Louis]

Hi Outbrain Team

How can I use the API to upload image creatives to Outbrain and retrieve the asset ID for use in the `imageMetadata` field of `https://api.outbrain.com/amplify/v0.1/campaigns/campaignId/promotedLinks`?

Best regards

shaw

[bryn.whitcomb]

Hey Shaw, 

Thanks for reaching out!

The first time you are uploading a new image asset, you can use the "url" field within the "imageMetadata" object to upload the image via URL. You can see an example of this in our documentation here. 

Once you've successfully created a new promoted link, the "id" field under the "imageMetadata" object will be returned in the response. You can use use either this image ID, the original image URL, or the 'requestedImageUrl' (also returned in the response) when creating new promoted links with the same image in the future. 

Please let me know if you have any further questions!

Best, 

Bryn