Publishing API

Create job

Publish an uploaded media object to a connected social account. Returns immediately with a job id — track progress via GET or a webhook.

POST/v1/publishing/jobs

Body parameters

`connectionId` stringrequired	Target connection id from GET /v1/connections.
`mediaKey` stringrequired	Key returned by the upload intent after all chunks complete.
`title` stringrequired	Post title / video title on the provider.
`description` string	Caption or description body.
`privacy` string	Provider privacy value, e.g. public \| unlisted \| private.
`scheduledAt` string (ISO 8601)	Optional scheduled publish time on providers that support it.
`webhookUrl` string (URL)	HTTPS endpoint to notify on job completion.

Request

curl -X POST "https://api.lyncut.com/v1/publishing/jobs" \
  -H "x-lyncut-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: pub-2026-09-23-001" \
  -H "Content-Type: application/json" \
  -d '{"connectionId":"con_9f3a","mediaKey":"upl_77kd","title":"Launch teaser"}'

Response

{
  "data": {
    "id": "job_8f2",
    "status": "QUEUED",
    "connectionId": "con_9f3a",
    "createdAt": "2026-09-23T15:30:00.000Z"
  }
}

Was this page helpful?

PreviousCreate upload intent Next Get job

Request

curl -X POST "https://api.lyncut.com/v1/publishing/jobs" \
  -H "x-lyncut-api-key: YOUR_API_KEY" \
  -H "Idempotency-Key: pub-2026-09-23-001" \
  -H "Content-Type: application/json" \
  -d '{"connectionId":"con_9f3a","mediaKey":"upl_77kd","title":"Launch teaser"}'

Response

{
  "data": {
    "id": "job_8f2",
    "status": "QUEUED",
    "connectionId": "con_9f3a",
    "createdAt": "2026-09-23T15:30:00.000Z"
  }
}