AdnovaDocs
Creative Hub

Creative Hub overview

Organise creative assets in workspace boards; upload images and video.

The Creative Hub API manages your creative assets — organise files into boards and upload images or video via a signed-URL handshake. Assets uploaded here are referenced by fileId in Ad Launcher launch payloads.

What you can do

Typical flow

  1. Create a board. Create a board or List boards to pick an existing one.
  2. Upload a file. Upload a file with the boardId, then PUT the bytes to the returned uploadUrl.
  3. Complete the upload. Complete creative upload — the response carries the fileId and versionId.
  4. Browse board contents. List files in a board returns a board's direct children, filterable by extension, name, or date.

For large videos (>~50 MB), use the multipart flow instead of the single-PUT upload.

Once you have a fileId, pass it into an Ad Launcher launch payload.

Auth & request context

Every request needs three headers — the API key plus workspace and org context:

api-key: YOUR_KEY_HERE
x-workspace-id: YOUR_WORKSPACE_ID
x-org-id: YOUR_ORG_ID
  • api-key — required on every request. Create one from the Adnova dashboard.
  • x-workspace-id — required on every Creative Hub endpoint.
  • x-org-id — required on every Creative Hub endpoint.

The same API key works across Creative Hub, Ad Launcher, Manage, and Analytics.