Skip to content
Sign in

Reference

Build on the Lucra API.

Get API key Quickstart

Drag a sticker to move it. With the keyboard, the arrow keys move it and Enter picks the next one.

What changed

Changes to the API, newest first.

Changes to the API, newest first. Requests that send your Lucra-Version keep working as it changes.

October 27, 2026

Ads rebuilt

The ads engine was rebuilt under the same Lucra-Version: 2026-10-01. Requests that worked before still validate, and responses carry more: job, issues, options, template, storedStatus and platform IDs on campaigns, ad sets and ads. A few meanings changed:

  • billingLimit caps creator pay and fees billed through Lucra, not ad spend. null removes it.
  • Meta ad access moved from POST /v1/ad-authorizations to a program's creator approvals (GET /v1/applications, approvals). Ad authorizations are TikTok Spark codes.
  • GET /v1/ad-fields keys are option keys (meta.bidStrategy), the same ones options takes.
  • settings.creator (Snapchat creator partnerships) and pendingChange are retired. expiresAt on an ad authorization is ignored.
  • status: "archived" on an ad set or ad removes it from its campaign and the platform.
  • New error codes: ad_resource_removed, creator_not_authorized, platform_refused and provider_unavailable. Problems from a platform carry issues[] with the fix.