Developers

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.

On this pageGet your API keyBase URL & authenticationList channelsUpload mediaCreate a postList and delete postsRate limits