API request builder
Build a POST https://api.skedcast.com/v1/posts request and copy it as curl or JSON.
This builds a request. It does not call the SkedCast API. Copy the curl command and replace
YOUR_API_KEY and the ids with your own to run it.The client the post belongs to.
curl -X POST 'https://api.skedcast.com/v1/posts' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: YOUR_UNIQUE_KEY' \
-d '{"clientId":"00000000-0000-4000-8000-000000000001","content":"Launch day is here 🚀","mediaIds":[],"targets":{"mode":"accounts","accountIds":["00000000-0000-4000-8000-000000000002"]},"schedule":{"type":"now"}}'Frequently asked questions
- How do I send the request?
- Copy the curl command, replace YOUR_API_KEY with your API key and the ids with your own, and run it. The key goes in the Authorization header as a bearer token.
- Which fields does the request use?
- The ones POST /v1/posts accepts: clientId, content, targets, schedule and aiDisclosure. The API reference describes every field.
- What is the difference between the two curl options?
- POST /v1/posts schedules the post. POST /v1/posts/preview validates the same body and returns the result for each platform without creating anything. It does not need an Idempotency-Key.
- Why does the curl command include an Idempotency-Key header?
- Every POST, PATCH and DELETE needs one, so a retried request never schedules a post twice. Replace the placeholder with a unique value for each request.
- What does the target change?
- Specific accounts takes a list of account ids. A whole client group takes one client id and publishes to every account in that client.
- Where do I get an API key?
- Create one in the SkedCast console. API keys are available on plans that include API access; see the pricing page.
Ready to broadcast everywhere?
Sign up free — no credit card. You land on the Free plan, and you can start a one-time 7-day Studio trial from your workspace whenever you are ready. Connect your first accounts, import a batch, and watch one post fan out across every platform.