Skip to main content
POST

Publish Project

Publish or schedule an exported project to one or more connected social platforms (YouTube, TikTok, Instagram, X/Twitter, Facebook, LinkedIn).
This endpoint requires authentication. The project must already be exported (have a downloadUrl), and the social accounts you want to publish to must be connected from the Publishing page in the dashboard.

Authentication

string
required
Your Submagic API key starting with sk-

Path Parameters

string
required
The unique identifier (UUID) of the exported project to publish

Request Body

string
ISO 8601 timestamp to schedule the publication for a future time. Must be in the future. Omit to publish immediately. Scheduled publications return a 202 Accepted response; immediate publications return 200 OK.
object
required
Per-platform publishing options. At least one platform must be provided. Unknown keys are rejected.

Prerequisites

Before publishing a project, ensure:
  • Project is exported: The project must have a downloadUrl (status completed)
  • Project ownership: The project must belong to the authenticated user
  • Accounts connected: Each requested platform must be connected from the Publishing page in the dashboard
  • Sufficient credits: Your account must have enough API credits

Response

string
Unique identifier of the publication
string
The unique identifier of the project being published
boolean
true if the publication was scheduled for a future time, false if published immediately
string
ISO 8601 timestamp of when the publication was published or is scheduled to publish
string
Current status of the publication: published, scheduled, processing, or failed
array
Array of platforms the project is being published to

Tracking Published Posts

After publishing, use the List Published Projects endpoint to retrieve the status, platform URLs, and analytics of your posts.
Tip: To connect a YouTube, TikTok, Instagram, X (Twitter), Facebook, or LinkedIn account, visit the Publishing page in the dashboard. Once connected, the account is available to all publish requests for that user.
Important: Publication to upstream platforms is asynchronous. A 200 response means the request was accepted and posts have been dispatched, but individual platform delivery (especially for scheduled posts) is finalized in the background. Poll the List Published Projects endpoint to track per-platform publishStatus.