Sprkly
← Back to Resources
FAQ · 1 min read

Can I schedule posts with an API?

Yes. Sprkly has a REST API so you can schedule posts straight from your own tools, a CMS, or a no-code automation — without opening the app.

1. Create an API key

In Settings, create an API key and copy it somewhere safe (you only see it once). Give it the scopes you need: post:write, post:read, media:write, and account:read. Keep the key secret — never put it in frontend code, screenshots, or public templates.

2. Find your connected account IDs

Call GET /api/v1/connections to list the accounts you've connected and their profileIds — you pass these when scheduling.

3. Schedule a post

POST /api/v1/posts with your caption, target platforms, profile IDs, media, and a scheduledTime. Sprkly publishes it at that minute through the same reliable publisher the app uses.

curl -X POST https://sprkly.app/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["instagram"],
    "profileIds": ["YOUR_PROFILE_ID"],
    "caption": "Shipped something new today ✨",
    "mediaUrls": ["https://example.com/photo.jpg"],
    "scheduledTime": "2026-06-20T14:00:00.000Z",
    "externalId": "my-app-post-123"
  }'

Pass a stable externalId (such as your own record ID) so retries never create duplicate posts. Poll GET /api/v1/posts/{id} for status, permalink, and publishedAt. TikTok and YouTube also require a title, and TikTok requires platformMeta.tiktok.privacyLevel.

Connect it to Zapier or Make

Prefer no-code? See Build Zapier and Make templates with the Sprkly API for ready-to-fork setups. The full endpoint reference lives in the API docs.

Rather not touch code at all?

If the API is more than you want to deal with, we'll do it for you — see Done-for-you scheduling.

Still have a question?

Email [email protected] — we reply within 24 hours.