Schedule posts to every network with one social media API
The Pallyy API is a REST API for scheduling social media posts: create drafts, schedule posts, and import media across ten networks with one key. Included on every paid plan.
Turn any AI assistant into a social media AI agent
The Pallyy API is plain REST with docs that read as markdown, so any AI assistant that can make HTTP requests can run it for you. Paste a key, point it at the docs, and ask in plain language.
Create a key just for the assistant
Each assistant gets its own key, named after the tool, with edit posts granted (plus upload media if it should import images), publish posts left off, and access restricted to one social set.
Keys and permissionsGive it the key and the docs
The assistant only needs the key and the docs link. Every docs page is available as markdown by adding .md to its URL, so it can read the full reference itself.
API documentationAsk in plain language
Plain-language requests are enough: "Create an Instagram draft for Friday 9am with this image" or "move Monday's post to Tuesday". The assistant lists your social sets, imports media, and creates the post; you review and publish.
Post sets referenceStarter prompt
Paste into any assistantUse the Pallyy API to manage my account. Docs: https://pallyy.com/docs/api (add .md to any page for markdown). My key is pallyy_your_api_key, sent as a bearer token. When I ask for a post: find the right social set, import any image I give you, and create the post as a DRAFT so I can review it in Pallyy.
Treat the key like a password: one key per assistant with only the permissions it needs, publish posts left off so it drafts and you publish, and revoke it from Settings > API keys when you stop using that tool.
The publishing workflow, over the API
The Pallyy API creates, schedules, and reviews posts the way your team does in the app, with keys you can scope to exactly what each integration is allowed to do.
Scoped permissions
Pallyy API keys start read-only. Edit posts, publish posts, and upload media are granted separately, so an integration can draft without ever being able to publish.
Social set restrictions
A key can be limited to specific social sets, so a client integration only sees that client's accounts. Everything outside them answers with a 404.
Drafts and scheduling
A post set is created as a draft or as scheduled, with one post per network. Drafts validate loosely, so incomplete content can be parked for a person to finish.
Approval workflow
The approval state on any post can be set, filtered, and updated over the API, and the post lands in the same review queue and shared calendars your team already uses.
Repeating series
One request can create a daily, weekly, monthly, or yearly series of up to 50 posts, each editable on its own afterwards.
Per-network fields
Posts carry the per-network options they need to publish: Instagram post types and collaborators, Pinterest boards, YouTube privacy, and Google Business calls to action.
First comments
An Instagram first comment can be scheduled with the post, so hashtags or links land the moment it publishes.
Alt text and image tags
Every image can carry alt text and Instagram account tags placed by position, the same way the composer does.
Media imports by URL
Images and videos are imported from a public URL into the right media library. Poll until the upload is ready, then reuse the library id across posts.
Publish results
Published posts return the network's post id and permalink, and failed posts return a reason code you can act on.
Post history audit trail
Every set's history names the API key that created or changed it, next to the comments and approval changes from your team.
Rate limits and errors
The Pallyy API allows 5 requests per second, with X-RateLimit headers on every response and a machine-readable code on every error, one entry per invalid post.
Post to ten networks through one social media API
One request to Pallyy replaces ten separate network integrations, app reviews and token refreshes included. Reels, carousels, stories, LinkedIn pages, Google Business posts, and YouTube uploads are all covered.
Approval workflows that run through the API
Every post created through the Pallyy API carries an approval state you can set, filter, and update. Reviewers approve in Pallyy as usual, and you decide whether approval gates publishing.
Request approval
A post created with its approval set to pending lands in the review queue and on the client's shared calendar, waiting for sign-off.
Getting client approvalRequest changes
A reviewer who requests changes parks the post as a draft with their comment. Your integration lists posts by approval state, applies the edits, and sets it back to pending.
How approvals workApproved
An approved post publishes at its scheduled time, or your integration schedules the approved draft itself. Every step sits in post history with the key that made it.
The approvals featureHow the Pallyy API works
The Pallyy API takes you from a new API key to a published post in five steps: create a key, list your social sets, import media, create a post set, and read back the result. Every request is validated against the same network rules and plan limits as the app.
Create an API key
Open Settings > API keys, name the key, choose its permissions (edit posts, publish posts, upload media), and optionally restrict it to specific social sets. The key is shown once, so store it safely.
List your social sets
Call GET /v1/social-sets to get every brand or client workspace the key can access, with its connected accounts, timezone, and the id every other request needs.
Import media by URL
Send a public image or video URL to POST /v1/media-upload. Pallyy downloads and processes it in the background; poll until it is ready and you have a media library id to post with.
Create a post set
POST /v1/post-sets with a publish time, a status of draft or scheduled, and one post per network, each with its own caption, media, and network fields. Invalid posts are rejected with a reason before anything is scheduled.
Track the result
Read the set back with GET /v1/post-sets/{id}. Its status moves from scheduled to publishing to published, and every post carries the network's post id and permalink, or a failure reason if the network rejected it.
Every endpoint, documented
The Pallyy API lives at app.pallyy.com/api/v1, authenticates with a bearer API key, sends and returns JSON, and allows 5 requests per second per account.
What teams build with a social media API
Pallyy's social media posting API is the same publishing engine as the app, so anything that can send an HTTP request can put posts on your content calendar, drafts included.
Publish from your own product
Listings, products, articles, or events that go live in your system can schedule their own social posts, instead of being copied into a scheduler by hand.
Automate with workflow tools
Anything that can send an HTTP request can create posts, from a cron job to Zapier, Make, or n8n. Scoped keys keep an automation drafting until a person publishes.
Run AI content pipelines
An AI pipeline can generate captions with your own models, import the generated images by URL, and park everything as pending drafts so nothing publishes without review.
Build client portals and internal tools
Clients or teammates can submit content from your own interface and have it land on the right social set's calendar, with the API key restricted to just that set.
Questions, answered
What is a social media API?
A social media API is a programming interface that lets your own software create, schedule, and read social media posts without using a scheduling app's interface. The Pallyy API is a unified social media API: one REST API and one key cover Instagram, Facebook, X, LinkedIn, Google Business, Pinterest, TikTok, YouTube, Threads, and Bluesky, instead of a separate integration with each platform's own API.
Which social networks does the Pallyy API support?
The API publishes to Instagram, Facebook, X, LinkedIn pages and personal profiles, Google Business, Pinterest, TikTok, YouTube, Threads, and Bluesky, the same networks the app supports. Each post carries the network-specific fields it needs, such as the Instagram post type, a Pinterest title and board, a YouTube privacy setting, or a Google Business call-to-action.
Which plans include API access?
Pallyy API access is included on every paid plan: Starter, Pro, Agency, and Scale. The free plan does not include it. If your plan does not include the API, the API keys page in Settings prompts you to upgrade.
How do I get a Pallyy API key?
Pallyy API keys are created under Settings > API keys in your Pallyy account. Give the key a name, choose its permissions, optionally restrict it to specific social sets, and confirm your password. The full key is shown once, on creation, and you can have up to 10 active keys per account.
What are the API rate limits?
The Pallyy API allows 5 requests per second per account, shared across all of the account's keys. Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers, and requests over the limit receive a 429 with a Retry-After header of one second.
Can I upload images and videos through the API?
The Pallyy API imports images and videos from any publicly reachable URL into a social set's media library, processing them in the background. Poll the upload until its status is ready, then use the returned media library id in your posts. Up to 5 uploads can be pending per social set at once, and imported bytes count against your plan's monthly upload allowance and storage.
Do posts created through the API count against my plan?
Posts created through the Pallyy API count against your monthly post limit exactly like posts created in the app, and plan features such as video posts, carousels, repeating posts, and approvals are enforced on every request. Requests that exceed a limit return a 403 with a code explaining which limit applied.
Can the API create drafts and use the approval workflow?
The Pallyy API creates post sets as drafts or scheduled posts, with an approval state of none, pending review, approved, or changes requested, and you can filter and update posts by approval state. Approval tracks review while status decides publishing, so create posts as pending drafts if nothing should publish until a reviewer approves it. Approvals need the Pro plan or above, and a key that only has the edit posts permission can create drafts but never schedule them.
Can I read analytics through the API?
The Pallyy API does not currently expose analytics. It covers social sets, post sets, the media library, and media uploads, while analytics and reports stay in the app.
Is there an SDK for the Pallyy API?
Pallyy does not publish an official SDK. The API is a plain REST API over HTTPS with JSON bodies and bearer token authentication, so it works with any HTTP client in any language, and the documentation uses curl examples you can translate directly.
Can I use the Pallyy API with ChatGPT, Claude, or Grok?
Any AI assistant that can make HTTP requests, including ChatGPT, Claude, and Grok, can use the Pallyy API. Create a key with only the permissions the assistant needs, paste it into the chat with a link to the docs, and ask for what you want in plain language. The assistant reads the markdown docs, calls the endpoints, and your posts appear on the Pallyy calendar, as drafts if you left the publish permission off.
How are API keys kept secure?
Pallyy API keys are stored hashed and only shown in full once, when created. Creating, editing, or revoking a key requires your account password, keys can be disabled or revoked at any time, and each key can be limited to read-only access or to specific social sets so a leaked key exposes as little as possible.