Social media automation API
Prepare campaign workflows from code
Wahlu's public API has 15 released operations. This page focuses on the thirteen-operation preparation subset for discovery, media acquisition and repair, drafts, live TikTok privacy choices, precise same-draft privacy updates, preflight, and held Schedules; the full contract also provides redacted publish receipts and exact receipt-bound cleanup. Build workflows in n8n, Make, Zapier, or your own backend without relying on private routes. Start with a pending_review Schedule: it stays held and creates no execution, job, or provider request.
Core endpoints teams use first
- GET /v1/context, GET /v1/platforms/capabilities, and GET /v1/brands/:brand_id/targets — discover your authorised brand, supported formats, and usable accounts
- GET /v1/brands/:brand_id/targets/:integration_id/dynamic-options — safely read the exact privacy choices currently supported by one selected TikTok target
- POST /v1/brands/:brand_id/targets/:integration_id/dynamic-options — explicitly refresh those choices when current credentials cannot support the safe read
- POST /v1/brands/:brand_id/media/imports, then GET /v1/brands/:brand_id/media/:media_id once — import remote media and inspect its explicit readiness
- POST /v1/brands/:brand_id/media/:media_id/repair-derivatives — explicitly create a reviewed centre-crop or padded derivative without overwriting the original
- POST /v1/brands/:brand_id/content-items, optionally PUT /v1/brands/:brand_id/content-items/:content_item_id/tiktok-privacy, then POST /v1/brands/:brand_id/content-items/:content_item_id/preflight — create a draft, set a live-validated TikTok privacy choice on that same draft, and run write-free checks
- POST /v1/brands/:brand_id/schedules, then GET /v1/brands/:brand_id/schedules/:schedule_id — create a pending-review Schedule and read its held status
- GET /v1/brands/:brand_id/schedules/:schedule_id/receipt, then POST /v1/brands/:brand_id/schedules/:schedule_id/provider-cleanup when the exact receipt grants bounded cleanup authority
For product teams
Prepare held campaign Schedules from product events such as launches, changelog entries, onboarding emails, and customer milestones. A human can review the explicit blocker and next actions before granting higher-authority approval.
For agencies
Standardise campaign delivery across clients with one API contract, predictable payloads, and clean audit history.
Need an API for reliable campaign operations?
Generate a key, connect your stack, and build the held workflow from media import to pending-review Schedule.