How do I create a post?
POST /api/public/v1/posts uses platform and content. Send the intended workspace ID in x-aidelly-workspace-id and a unique Idempotency-Key. Use the API reference for the full request schema.
the REST API + Aidelly
Connect Aidelly to the REST API.
Create an integration key, copy a read-only request, and choose the workspace your application will use.
Set up in 3 steps
- 1
Create an Aidelly integration key
Open API Keys, create a key for this integration, and copy it. Keep the key private; paste it only into the app’s credentials field.
Open Aidelly API Keys - 2
Set your key in your environment
Set AIDELLY_API_KEY in your local environment or secret manager using the key you copied. The request below reads it from that variable; do not put your key in shared code.
- 3
List your workspaces
Copy this GET request into your terminal. Use a returned workspace ID as x-aidelly-workspace-id on subsequent workspace requests.
Open API referenceRead-only curl requestCopy, then paste where the step asks you to.
Once you are connected
- List your workspaces and connected social accounts.
- Create drafts with your brand context.
- Schedule content for the intended social account.
- Review approvals and check post status.
Choose the intended Aidelly workspace before creating content. Review drafts and connected social accounts before scheduling or publishing.
Common questions
What does HTTP 201 mean?
The request was accepted into asynchronous processing. It does not confirm publication. Check the post status and provider post ID before treating the post as delivered.
One workspace for your agency and clients
Keep brand context, connected accounts, drafts and approvals together in Aidelly. Give each client a workspace so your team can review the right content in the right place.
Explore Aidelly for agencies