# Postify

> Postify is an AI-powered social media scheduler: compose once, tailor per platform, and publish to X, Instagram, TikTok, YouTube, LinkedIn, Facebook, Threads, Bluesky, Pinterest, and Reddit. It ships a public REST API (v1), Standard-Webhooks-signed outbound events, and a remote MCP server.

## Instructions for agents

- Every docs page has a Markdown twin: append `.md` to its URL. Prefer the twins — they are token-lean.
- Full docs in one file: https://usepostify.com/llms-full.txt
- OpenAPI 3.1 spec (all 17 operations, full schemas): https://app.usepostify.com/v1/openapi.json
- MCP server (10 tools, OAuth 2.1): `claude mcp add --transport http postify https://app.usepostify.com/api/mcp`
- Auth: org API keys minted at https://app.usepostify.com/settings/api-keys, sent as `Authorization: Bearer postify_live_…` or `x-api-key`. Base URL: `https://app.usepostify.com/v1`.
- Errors are RFC 9457 problem+json with a stable `code`; 429 `rate_limited` is retryable after `Retry-After`, 429 `quota_exhausted` is not.
- Send `Idempotency-Key` on POST /v1/posts. Delete/publish-now require the workspace's dangerous-operations opt-in (403 `dangerous_ops_disabled` otherwise).

## Docs

- [Developer overview](https://usepostify.com/developers.md): API, SDK, webhooks, MCP, rate limits
- [API quickstart & concepts](https://usepostify.com/docs/api.md): auth, scopes, errors, pagination, idempotency, rate limits
- [Webhooks](https://usepostify.com/docs/api/webhooks.md): event catalog, Standard Webhooks verification, retry schedule
- [For AI agents](https://usepostify.com/docs/ai.md): agent guidelines and machine-readable surfaces
- [Error codes](https://usepostify.com/docs/api/problems.md): all 14 problem codes

## API operations

- [getAnalytics](https://usepostify.com/docs/api/getAnalytics.md): GET /v1/analytics — Get workspace analytics
- [listChannels](https://usepostify.com/docs/api/listChannels.md): GET /v1/channels — List channels
- [listMedia](https://usepostify.com/docs/api/listMedia.md): GET /v1/media — List media assets
- [createMediaUpload](https://usepostify.com/docs/api/createMediaUpload.md): POST /v1/media/uploads — Start a media upload
- [completeMediaUpload](https://usepostify.com/docs/api/completeMediaUpload.md): POST /v1/media/uploads/{id}/complete — Complete a media upload
- [listPosts](https://usepostify.com/docs/api/listPosts.md): GET /v1/posts — List posts
- [createPost](https://usepostify.com/docs/api/createPost.md): POST /v1/posts — Create a post
- [getPost](https://usepostify.com/docs/api/getPost.md): GET /v1/posts/{id} — Get a post
- [reschedulePost](https://usepostify.com/docs/api/reschedulePost.md): PATCH /v1/posts/{id} — Reschedule a post
- [deletePost](https://usepostify.com/docs/api/deletePost.md): DELETE /v1/posts/{id} — Delete a post
- [publishPost](https://usepostify.com/docs/api/publishPost.md): POST /v1/posts/{id}/publish — Publish a post now
- [getUsage](https://usepostify.com/docs/api/getUsage.md): GET /v1/usage — Get plan usage
- [listWebhookEndpoints](https://usepostify.com/docs/api/listWebhookEndpoints.md): GET /v1/webhook-endpoints — List webhook endpoints
- [createWebhookEndpoint](https://usepostify.com/docs/api/createWebhookEndpoint.md): POST /v1/webhook-endpoints — Create a webhook endpoint
- [updateWebhookEndpoint](https://usepostify.com/docs/api/updateWebhookEndpoint.md): PATCH /v1/webhook-endpoints/{id} — Update a webhook endpoint
- [deleteWebhookEndpoint](https://usepostify.com/docs/api/deleteWebhookEndpoint.md): DELETE /v1/webhook-endpoints/{id} — Delete a webhook endpoint
- [testWebhookEndpoint](https://usepostify.com/docs/api/testWebhookEndpoint.md): POST /v1/webhook-endpoints/{id}/test — Send a test delivery

## Error codes

- [invalid_request](https://usepostify.com/docs/api/problems/invalid-request.md): HTTP 400 — Invalid request
- [validation_failed](https://usepostify.com/docs/api/problems/validation-failed.md): HTTP 400 — Request validation failed
- [authentication_required](https://usepostify.com/docs/api/problems/authentication-required.md): HTTP 401 — Authentication required
- [invalid_api_key](https://usepostify.com/docs/api/problems/invalid-api-key.md): HTTP 401 — Invalid API key
- [insufficient_scope](https://usepostify.com/docs/api/problems/insufficient-scope.md): HTTP 403 — API credential lacks the required scope
- [feature_not_enabled](https://usepostify.com/docs/api/problems/feature-not-enabled.md): HTTP 403 — Feature not available on the current plan
- [dangerous_ops_disabled](https://usepostify.com/docs/api/problems/dangerous-ops-disabled.md): HTTP 403 — Dangerous AI operations are disabled for this workspace
- [resource_not_found](https://usepostify.com/docs/api/problems/resource-not-found.md): HTTP 404 — Resource not found
- [resource_conflict](https://usepostify.com/docs/api/problems/resource-conflict.md): HTTP 409 — Resource state conflicts with the request
- [idempotency_in_progress](https://usepostify.com/docs/api/problems/idempotency-in-progress.md): HTTP 409 — A request with this idempotency key is still in progress
- [idempotency_key_reused](https://usepostify.com/docs/api/problems/idempotency-key-reused.md): HTTP 422 — Idempotency key reused with a different request body
- [rate_limited](https://usepostify.com/docs/api/problems/rate-limited.md): HTTP 429 — Rate limit exceeded
- [quota_exhausted](https://usepostify.com/docs/api/problems/quota-exhausted.md): HTTP 429 — Plan quota exhausted for this billing period
- [internal_error](https://usepostify.com/docs/api/problems/internal-error.md): HTTP 500 — Internal server error

## Changelog

- [TypeScript SDK preview + developer docs portal](https://usepostify.com/changelog/typescript-sdk-preview-developer-docs.md) (2026-07-20)
- [Outbound webhooks: Standard Webhooks signing, durable retries, failure ladder](https://usepostify.com/changelog/outbound-webhooks-standard-webhooks.md) (2026-07-20)
- [Posts, media, analytics and usage endpoints + idempotency and plan metering](https://usepostify.com/changelog/posts-media-analytics-usage-endpoints.md) (2026-07-19)
- [Public API v1: /v1 launch with OpenAPI 3.1 + interactive reference](https://usepostify.com/changelog/public-api-v1-launch.md) (2026-07-19)

## Product

- [Home](https://usepostify.com/): what Postify is
- [Pricing](https://usepostify.com/pricing): Free, Starter $24/mo, Team $39/mo, Agency $79/mo — every plan includes the API
- App: https://app.usepostify.com