Skip to content
adscapi

creatives

Upload an ad image to a platform and get back a platform-side creative id. Same engine as uploadCreative() in the SDK. Meta ships today; Pinterest and Reddit are accepted by the CLI and may skip until implemented.

Usage

shell
adscapi creatives upload --platform meta|pinterest|reddit --image <url> [--name <n>]

The subcommand word is upload (parsed as a positional before flags). Missing required flags print usage and exit 1.

Flags

FlagRequiredEffect
--platform <p>yesOne of meta, pinterest, reddit (Meta is live today)
--image <url>yesPublic image URL the platform can fetch
--name <n>noOptional creative name on the platform side

Output

shell
$ npx adscapi creatives upload --platform meta --image https://cdn.example.com/hero.jpg --name hero-v1
  [OK] meta id=1234567890

$ npx adscapi creatives upload --platform pinterest --image https://cdn.example.com/hero.jpg
  [skip] pinterest — not implemented yet

$ npx adscapi creatives upload --platform meta
usage: adscapi creatives upload --platform meta|pinterest|reddit --image <url> [--name <n>]
  • [OK] {platform} id={id} — upload succeeded
  • [skip] {platform} — {reason} — platform not live yet
  • [ERR] {platform} — {error} — upload failed, exit 1

Related