# Pallyy API

Pallyy's social media API lets your own software create drafts, schedule posts, and import media across ten social networks with one REST API and one API key, on every paid plan.

Last updated: 2026-08-26.

## What it does

- Publishes to Instagram, Facebook, X, LinkedIn pages and personal profiles, Google Business, Pinterest, TikTok, YouTube, Threads, and Bluesky, the same networks as the app.
- One REST API at https://app.pallyy.com/api/v1 with JSON requests and responses and bearer token authentication using keys that start with pallyy_.
- Creates post sets as drafts or scheduled posts, with one post per network carrying its own caption, media, alt text, and network-specific fields such as Instagram post type, first comment, Pinterest title and board, YouTube privacy, and Google Business call-to-action.
- Supports the approval workflow (none, pending review, approved, changes requested): set it on create, filter by it on list, change it on update. Approval tracks review and status decides publishing; approving in Pallyy never schedules a post and requesting changes parks it as a draft. Create posts as DRAFT + PENDING so nothing publishes until approved, or SCHEDULED + PENDING to publish on time unless changes are requested. Approvals need Pro or above.
- Supports repeating series (daily, weekly, monthly, yearly, 2 to 50 occurrences).
- Imports images and videos into a social set's media library from a public URL, processed in the background and polled until ready.
- Lists social sets with their connected accounts, lists and filters post sets, and browses the media library.
- Published posts return the network's post id and permalink; failed posts return a reason code.
- Keys are scoped: read-only by default, with optional edit posts, publish posts, and upload media permissions, and can be restricted to specific social sets.
- Rate limit of 5 requests per second per account with X-RateLimit headers and 429 responses.
- Post history in Pallyy names the API key that created or changed a post.
- Included on Starter, Pro, Agency, and Scale; not on the free plan.
- Works with AI assistants such as Claude, ChatGPT, and Grok: give the assistant a scoped key and the docs link (every docs page is available as markdown by adding .md) and ask for posts in plain language; leave the publish permission off so it drafts and you publish.

## How it works

- Create an API key under Settings > API keys, choosing permissions and optional social set restrictions; the key is shown once.
- List social sets with GET /v1/social-sets to get the socialSetId other requests need.
- Import media with POST /v1/media-upload and poll GET /v1/media-upload/{id} until status is READY.
- Create a post set with POST /v1/post-sets, passing scheduledAt, status (DRAFT or SCHEDULED), approval, and one post per network.
- Read the set back with GET /v1/post-sets/{id} to track status and per-post publish results.

## Common questions

- What is a social media API: A programming interface that lets software create, schedule, and read social posts; Pallyy's is a unified API covering every connected network with one key.
- Which networks are supported: Instagram, Facebook, X, LinkedIn, Google Business, Pinterest, TikTok, YouTube, Threads, and Bluesky.
- Which plans include API access: Starter, Pro, Agency, and Scale; not the free plan.
- How do I get an API key: Settings > API keys in the app; up to 10 active keys per account, password required to create, edit, or revoke.
- What are the rate limits: 5 requests per second per account, shared across keys, with X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers.
- Can I upload media: Yes, by public URL through the media upload endpoint; up to 5 pending uploads per social set, bytes count against the plan's upload allowance and storage.
- Do API posts count against my plan: Yes, the monthly post limit and plan features such as video, carousels, repeats, and approvals are enforced on every request.
- Can the API create drafts and use approvals: Yes, status DRAFT or SCHEDULED and any approval state, with filtering and updates by approval; approval tracks review, status decides publishing; Pro plan or above; edit-only keys can draft but not schedule.
- Can I read analytics: Not currently; the API covers social sets, post sets, the media library, and media uploads.
- Is there an SDK: No official SDK; it is plain REST over HTTPS and works with any HTTP client.
- Can I use it with ChatGPT, Claude, or Grok: Yes, any assistant that can make HTTP requests; create a scoped key, paste it with the docs link, and ask in plain language.
- How are keys secured: Stored hashed, shown once, password-confirmed writes, disable or revoke at any time, scoped permissions and social set restrictions.

## Related

- API documentation: https://pallyy.com/docs/api
- Publishing: https://pallyy.com/features/publish
- Approvals: https://pallyy.com/features/approvals
- Integrations: https://pallyy.com/integrations
- All features: https://pallyy.com/features