Skip to main content

​
Welcome to PostSyncer API

PostSyncer offers a comprehensive RESTful API that enables you to programmatically manage your social media scheduling workflows. With our API, you can create, update, and delete posts, manage social media accounts, organize content with labels, and automate your social media strategy across multiple platforms.

​
Supported Platforms

PostSyncer supports scheduling and publishing content to the following social media platforms:

Twitter / X

Facebook

Instagram

TikTok

YouTube

Pinterest

Threads

Telegram

LinkedIn

Bluesky

​
API Versions

Our API is versioned to ensure backward compatibility as we continue to improve and expand our features.
VersionStatusBase URL
v1Currenthttps://postsyncer.com/api/v1

​
Authentication

All API requests must be authenticated using a Bearer token. You can generate API tokens from your PostSyncer account.
Don’t have an API token yet? Get one here.

​
Generating API Tokens

  1. Log in to your PostSyncer account at app.postsyncer.com
  2. Navigate to Settings → API Integration
  3. Click “Create”
  4. Select the necessary permissions for your use case:
    • posts - Create, read, update and delete posts
    • accounts - View and manage social media accounts
    • labels - Create and manage content labels
    • workspaces - View and manage workspaces
  5. Name your token something descriptive (e.g., “Website Integration”)
  6. Click “Create Token” and securely store the generated token
Your API token is displayed only once. Be sure to copy and store it securely, as it provides access to your PostSyncer account.

​
Using Your Token

Include your API token in the Authorization header of all requests: 
Authorization: Bearer YOUR_API_TOKEN
Keep your API tokens secure! They grant access to your PostSyncer account and should be treated like passwords. Never share your tokens publicly or commit them to version control.

​
Response Format

All API responses are returned in JSON format and include appropriate HTTP status codes.

​
Successful Responses

Successful responses will have HTTP status codes in the 2xx range and contain the requested data.

​
Error Responses

Error responses will have HTTP status codes in the 4xx or 5xx range and include an error message: 
{
  "message": "The provided token doesn't have permission to access this resource"
}

​
Common HTTP Status Codes

CodeDescription
200OK - Request successful
201Created - Resource created successfully
400Bad Request - Invalid parameters or validation errors
401Unauthorized - Missing or invalid API token
403Forbidden - Token lacks required permissions
404Not Found - Resource not found
422Unprocessable Entity - Validation errors
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Server error

​
Base URL

All API endpoints are relative to the base URL: 
https://postsyncer.com/api/v1

​
Getting Started

Ready to start integrating with PostSyncer? Follow our quick start guide to get up and running in minutes.

Quick Start Guide

Learn how to create your first API integration