View live campaigns and ads from Meta, Google, TikTok, LinkedIn, Pinterest, and X, or boost your best published posts into paid ads. Available on Power plans and above.

1. Connect ad accounts per platform on the Paid Ads page (Meta requires a connected Facebook/Instagram posting account; Google Ads connects standalone).
2. Sync to pull campaigns and performance metrics from all connected platforms.
3. Optionally boost a published Cuppa post into a new ad on your connected account.

Ads run on the customer’s own ad account, so ad spend is billed by the ad platform directly, not by Cuppa.

API platform filters (platform query param on list endpoints): facebook, instagram, google, tiktok, linkedin, pinterest, twitter. These map to Zernio’s list-ads/campaigns API slugs, not the stored connect values (metaads, googleads, etc.).

Endpoint	MCP Tool	CLI Command	Description
GET /v1/social/ads/accounts	list_ad_accounts	cuppa social ads accounts	List connected ad accounts
GET /v1/social/ads/campaigns	list_ad_campaigns	cuppa social ads campaigns	List live campaigns with metrics
GET /v1/social/ads	list_ads	cuppa social ads list	List ads (platform + Cuppa-boosted) with metrics
POST /v1/social/ads/boost	boost_post	cuppa social ads boost	Boost a published post into an ad

Creative Lab

Generate net-new paid ad creative (copy plus an on-brand image) instead of only boosting existing posts. Pick a platform and format, describe the product and offer, then generate one ad, a batch of variants (up to 20), or remix a winning ad into fresh angles. Image generation uses your team’s Replicate key.

You can also generate an ad and a matching landing page draft in one shot: enable “Also create a matching landing page draft” (single only). Cuppa creates a linked landing page draft using the same offer, so the ad click destination matches the ad creative. The landing page appears in your Pages list and is linked from the creative card.

Generated creatives land in a review grid as drafts. Edit copy inline, save the ones you want to keep, or discard the rest. Batch jobs run in the background, so poll the status endpoint (or watch the review grid) until they complete.

Endpoint	MCP Tool	CLI Command	Description
POST /v1/social/ads/creatives	generate_ad	cuppa social ads generate	Generate ad creative(s); single, batch, or combo
GET /v1/social/ads/creatives/status	get_ad_batch_status	cuppa social ads status	Poll an async batch generation job
GET /v1/social/ads/creatives	list_ad_creatives	cuppa social ads creatives	List generated ad creatives
PATCH /v1/social/ads/creatives/\{id\}	update_ad_creative	cuppa social ads update-creative	Edit, save, or discard an ad creative

Generation modes on POST /v1/social/ads/creatives:

• count greater than 1 runs an async batch and returns a request_id. Poll the status endpoint, then list creatives filtered by batch_id.
• with_landing_page: true (with count: 1) returns the creative plus a page_id for the matching landing page draft.
• Otherwise a single creative is returned inline.

---