Public API
Create posts, upload media and list channels from your own code.
Get your API key
In the app go to Settings → Public API and copy your API key. Keep it secret – anyone with the key can post to your channels.
Base URL & authentication
Base URL: https://app.socialmacy.com/api/public/v1
Header: Authorization: YOUR_API_KEY
List channels
curl https://app.socialmacy.com/api/public/v1/integrations \
-H "Authorization: YOUR_API_KEY"
Returns your connected channels with their id, name, platform and picture. Use the id when creating posts.
Upload media
curl -X POST https://app.socialmacy.com/api/public/v1/upload \
-H "Authorization: YOUR_API_KEY" \
-F "file=@/path/to/image.jpg"
Returns the stored file's id and path to attach to a post.
Create a post
curl -X POST https://app.socialmacy.com/api/public/v1/posts \
-H "Authorization: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "schedule",
"date": "2026-12-01T10:00:00.000Z",
"shortLink": false,
"tags": [],
"posts": [{
"integration": { "id": "CHANNEL_ID" },
"value": [{ "content": "Hello from the Socialmacy API!", "image": [] }],
"settings": {}
}]
}'
type can be draft, schedule or now. Some platforms need extra fields in settings (for example a YouTube title or TikTok privacy level).
List and delete posts
GET https://app.socialmacy.com/api/public/v1/posts?startDate=...&endDate=...
DELETE https://app.socialmacy.com/api/public/v1/posts/POST_GROUP_ID
Rate limits
The API is rate limited per workspace. If you receive HTTP 429, wait and retry. Contact us if you need higher limits.