launch

Launch Campaign

Requires a connected platform — run /ads:setup first if needed.

1. Campaign hierarchy

The structure is the same across platforms — only entity names differ:

Level	Meta	Google	TikTok
Campaign	campaigns	campaigns	campaigns
Ad group	adsets	ad-groups	ad-groups
Ad	ads	ads	ads

Every adkit_manage call takes: platform, entity, action, and params.

2. Discover params then create

Call adkit_help path: "manage <platform> <entity> create" for the exact params. Universal params that work on every platform:

Param	Description
name	Entity name (required)
budget	{ daily: N } or { lifetime: N }
status	active or paused (default: paused)

Platform-specific params (targeting, optimization, bidding, pixel, channel) vary. Always discover them with adkit_help before your first mutation on a platform.

Create example (platform-agnostic pattern):

adkit_manage platform: "<platform>" entity: "campaigns" action: "create" params: { name: "Spring Sale", objective: "sales", budget: { daily: 50 } }

Then create the ad group referencing the campaign, then the ad referencing the ad group. Each returns a draft ID.

3. Media upload (all platforms)

Two upload methods:

Direct upload (default — handles most files):

adkit_manage platform: "<platform>" entity: "media" action: "upload" params: { source: "url", url: "<public-url>" }

Temporary upload URL (for local files or large assets):

1. entity: "media" action: "request_upload_url" with filename and contentType → returns a signed PUT URL and uploadId
2. PUT the file bytes to the signed URL
3. entity: "media" action: "upload" with { source: "temporary_upload", uploadId: "<id>" }

Or use adkit_studio to generate AI creatives instead of uploading.

Bulk media upload

For multiple creatives, repeat the upload flow for each file. Each upload returns a separate media ID. Then create one ad per media ID referencing the same ad group.