Can I schedule a Facebook Reel, not just a feed post?

Yes. Set variants[].overrides.contentType to "reel" on a facebook variant and put a video in mediaIds. Omit contentType (or set "feed") for a feed post, or set "story" for a Story.

Can I publish immediately instead of scheduling?

Yes. Send schedule: { "type": "now" } in the same POST /v1/posts call.

Publish to Facebook with the API

Browse docs

6 min read

What do you need before you publish?#

You need one connected account for the platform. Connect it in the SkedCast console. If a client owns the account, create a connect link with POST /v1/clients/{id}/connect-invites and send it to them. They authorize from that page without a SkedCast login.

GET /v1/accounts lists the connected accounts with their ids. Pass that id in targets.accountIds below.

How do you schedule a Facebook post with the API?#

bash

curl -X POST https://api.skedcast.com/v1/posts \
  -H "Authorization: Bearer sked_live_YOUR_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "<clientId>",
    "content": "Launch day is here 🚀",
    "mediaIds": ["<mediaAssetId>"],
    "targets": { "mode": "selection", "accountIds": ["<facebookAccountId>"] },
    "schedule": { "type": "at", "scheduledAt": "2030-01-15T15:00:00Z" }
  }'

A minimal Facebook post, scheduled for a specific time.

Which Facebook fields can you set?#

Put everything platform-specific in one variants entry with "platform": "facebook" and an overrides object. Send only facebook keys on a facebook variant. SkedCast reads the keys in the table below and ignores the rest.

Field	Type	Values / default	Notes
`contentType`	enum	`feed` \\| `reel` \\| `story`	Defaults to `feed`.
`firstComment`	string	—	Posted right after publish. Needs the Page engagement permission (`pages_manage_engagement`). If `missingPermissions` on `GET /v1/accounts/{id}` names it, reconnect the Page. Best-effort: a failed comment never fails the post. The outcome is reported as `firstCommentIssue` on `GET /v1/post-targets/{id}`.

How do you add Facebook-specific settings?#

json

{
  "clientId": "<clientId>",
  "content": "New product drop 📦",
  "mediaIds": ["<mediaAssetId>"],
  "targets": { "mode": "selection", "accountIds": ["<facebookAccountId>"] },
  "variants": [
    { "platform": "facebook", "overrides": { "contentType": "reel" } }
  ],
  "schedule": { "type": "at", "scheduledAt": "2030-01-15T15:00:00Z" }
}

The same POST /posts body, with a variants entry added.

How do you check that the post published?#

Publishing creates one post target per account. GET /v1/post-targets/{id} (or GET /v1/posts/{id}) reports status, plus externalId (Facebook's own post id) and permalink (its public URL) once published. To avoid polling, subscribe to the target.published and target.failed webhooks (see the webhooks guide).

facebookapipublish

FAQ

Can I schedule a Facebook Reel, not just a feed post?: Yes. Set variants[].overrides.contentType to "reel" on a facebook variant and put a video in mediaIds. Omit contentType (or set "feed") for a feed post, or set "story" for a Story.
Can I publish immediately instead of scheduling?: Yes. Send schedule: { "type": "now" } in the same POST /v1/posts call.