API Guide
Build faster with a guide that shows you what to do next.
Start with authentication, choose the right workspace, and send requests with less guesswork.
curl -X POST "https://api.postly.ai/..."
-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"workspaceId": "wk_123",
"content": "Your post content",
"socialIds": ["social_123"]
}'Everything you need, without the extra noise
Use the sections below to move from setup to shipping without digging through filler content.
How to use the API
Keep your flow simple.
Most integration issues come from sending requests before the right workspace or account is selected. Keep the order clear and your implementation stays easier to maintain.
1. Authenticate
Pass your API key with every request.
2. Select a workspace
Make sure your request points to the correct workspace before you fetch channels or publish content.
3. Send the payload
Keep fields explicit so the request is easy to debug and validate.
Best practices
Make each request easier to trust.
Authenticate every request clearly and early.
Choose the workspace before you fetch or publish anything.
Keep your payloads small, explicit, and easy to validate.
Use the reference when you need exact field names or edge-case behavior.
Ready to make your first request?
Use the docs for exact endpoint details, then open your dashboard when you want to test the flow in context.