---
source: https://autoadify.com/social-media-api
title: "Social media scheduling API"
---

# Social media scheduling API

> Autoadify's REST API schedules and publishes posts to every channel connected in Autoadify with one request, with per-platform text, media and a status per channel. Included on paid plans from Pro.

Base URL: `https://api.autoadify.com/v1` · Documentation: https://docs.autoadify.com · OpenAPI 3.1: https://docs.autoadify.com/openapi.json

## What it does

- **One call, every channel** - up to 20 channels per post, with per-platform text (`contentByPlatform`).
- **Now or later** - omit `publishAt` to publish now; scheduled posts can be edited or cancelled until they go out.
- **Rules checked when you schedule** - media requirements, video-only platforms, Reddit subreddits and TikTok options are validated at creation, not at publish time.
- **Media** - import from a public URL in one call, or upload a file directly to storage.
- **Status per channel** - published or failed, the live URL, and the error if one failed. Posts also appear in the Autoadify calendar.
- **Safe to retry** - an identical post within 5 minutes returns `409 duplicate_post` with the first post's id.

## Endpoints

- `GET /me` - The key's workspace, permissions and quota
- `GET /channels` - Connected channels and their posting rules
- `POST /posts` - Schedule a post, or publish it now
- `GET /posts` - List posts, filtered by status, channel or date
- `GET /posts/{id}` - A post's status, live URLs and errors per channel
- `PATCH /posts/{id}` - Edit a scheduled post
- `DELETE /posts/{id}` - Cancel a scheduled post
- `POST /media/import` - Import an image, video or PDF from a URL
- `POST /media/uploads` - Get a one-time upload URL for a file
- `POST /media/{id}/complete` - Finish an upload
- `GET /media` - List and search the media library
- `GET /media/{id}` - One media file
- `DELETE /media/{id}` - Delete a media file

## Example

```bash
curl https://api.autoadify.com/v1/posts \
  -H "Authorization: Bearer $AUTOADIFY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "We just shipped dark mode 🌙",
    "channelIds": ["ch_linkedin", "ch_x"],
    "contentByPlatform": { "X": "Dark mode is here 🌙" },
    "mediaIds": ["med_123"],
    "publishAt": "2026-10-20T09:00:00Z"
  }'
```

## Authentication

Bearer API keys, created in Autoadify under Settings → API & MCP (https://app.autoadify.com/settings/developers). Keys carry Read and/or Publish permissions, can be limited to chosen channels, and can expire. Revoking a key stops it everywhere within seconds.

## Plans

- **Pro** ($29/mo) - 10,000 a month (60/min), 3 API keys
- **Team** ($79/mo) - 100,000 a month (300/min), 15 API keys
- **Enterprise** ($299/mo) - Unlimited (1,000/min), Unlimited API keys

Requests never spend credits. The free plan has no API access. The API does not generate images or video yet.

---

_Source: https://autoadify.com/social-media-api_