Get Your API Key
Before you can use the PostSyncer API, you need to generate an API key.1
Sign In
Visit app.postsyncer.com and sign in to your account.
2
Generate API Key
Go to Settings → API Integrations and click “Create”. Copy the key immediately, as it won’t be shown again.
Your First API Request
Let’s start by listing your workspaces to verify your API key is working.curl -X GET "https://postsyncer.com/api/v1/workspaces" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
{
"id": 12,
"name": "abdulmejidshemsuawel",
"slug": "abdulmejidshemsuawel",
"type": "PERSONAL",
"logo": null,
"timezone": "Africa/Addis_Ababa",
"language": "en",
"accounts": [
{
"id": 136,
"platform": "twitter",
"username": "heyabdulmejid",
"name": "Abdul",
"avatar": "https://pbs.twimg.com/profile_images/1878383928995684352/3Xw5HTsk_400x400.jpg"
}
]
}
Create Your First Post
Now let’s create a simple text post across your connected accounts.curl -X POST "https://postsyncer.com/api/v1/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"workspace_id": 12,
"labels": [5],
"content": [
{
"text": "Post Once. Publish everywhere",
"media": [
"https://postsyncer.com/images/og/banner.png?v2"
]
}
],
"schedule_type": "schedule",
"schedule_for": {
"date": "2025-07-04",
"time": "23:00",
"timezone": "Africa/Addis_Ababa"
},
"accounts": [
{
"id": 136,
"settings": {
"for_super_followers_only": false,
"reply_settings": "everyone",
"quote_tweet_id": 1940147562003963969,
"reply": {
"in_reply_to_tweet_id": null
},
"community_id": null,
"share_with_followers": true,
"text": null
}
},
{
"id": 95,
"settings": {
"board_id": 871517034080685367
}
}
]
}'
{
"id": 123,
"workspace_id": 12,
"labels": [5],
"content": [
{
"text": "Pinterest publish",
"media": [
"https://cdn.pixabay.com/photo/2015/09/16/08/55/online-942406_1280.jpg"
]
},
{
"text": "ACVA",
"media": []
}
],
"schedule_type": "schedule",
"schedule_for": {
"date": "2025-07-04",
"time": "23:00",
"timezone": "Africa/Addis_Ababa"
},
"repeatable": true,
"repeatable_times": 2,
"repeatable_gap": 2,
"repeatable_gap_unit": "days",
"status": "scheduled",
"created_at": "2024-01-15T10:30:00Z",
"accounts": [
{
"id": 136,
"name": "Twitter Account",
"status": "scheduled",
"settings": {
"for_super_followers_only": false,
"reply_settings": "everyone",
"quote_tweet_id": 1940147562003963969,
"reply": {
"in_reply_to_tweet_id": null
},
"community_id": null,
"share_with_followers": true,
"text": null
}
},
{
"id": 95,
"name": "Pinterest Account",
"status": "scheduled",
"settings": {
"board_id": 871517034080685367
}
}
]
}
List Your Posts
Retrieve all your posts to see what you’ve created.curl -X GET "https://postsyncer.com/api/v1/posts" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"
SDK Examples
JavaScript/Node.js
const axios = require('axios');
const apiKey = 'YOUR_API_KEY';
const baseURL = 'https://postsyncer.com/api/v1';
const api = axios.create({
baseURL,
headers: {
'Authorization': `Bearer ${apiKey}`,
'Content-Type': 'application/json'
}
});
// Create a post
const createPost = async () => {
try {
const response = await api.post('/posts', {
workspace_id: 12,
labels: [5],
content: [
{
text: 'Hello from Node.js!',
media: []
}
],
schedule_type: 'schedule',
schedule_for: {
date: '2025-07-04',
time: '23:00',
timezone: 'Africa/Addis_Ababa'
},
repeatable: true,
repeatable_times: 2,
repeatable_gap: 2,
repeatable_gap_unit: 'days',
accounts: [
{
id: 136,
settings: {
for_super_followers_only: false,
reply_settings: 'everyone',
quote_tweet_id: null,
reply: {
in_reply_to_tweet_id: null
},
community_id: null,
share_with_followers: true,
text: null
}
}
]
});
console.log('Post created:', response.data);
} catch (error) {
console.error('Error:', error.response.data);
}
};
createPost();
Python
import requests
import json
from datetime import datetime, timedelta
api_key = 'YOUR_API_KEY'
base_url = 'https://postsyncer.com/api/v1'
headers = {
'Authorization': f'Bearer {api_key}',
'Content-Type': 'application/json'
}
# Create a post
def create_post():
data = {
'workspace_id': 12,
'labels': [5],
'content': [
{
'text': 'Hello from Python!',
'media': []
}
],
'schedule_type': 'schedule',
'schedule_for': {
'date': '2025-07-04',
'time': '23:00',
'timezone': 'Africa/Addis_Ababa'
},
'accounts': [
{
'id': 136,
'settings': {
'for_super_followers_only': False,
'reply_settings': 'everyone',
'quote_tweet_id': None,
'reply': {
'in_reply_to_tweet_id': None
},
'community_id': None,
'share_with_followers': true,
'text': None
}
}
]
}
response = requests.post(f'{base_url}/posts', headers=headers, json=data)
print('Post created:', response.json())
create_post()
PHP
<?php
$api_key = 'YOUR_API_KEY';
$base_url = 'https://postsyncer.com/api/v1';
$headers = [
'Authorization: Bearer ' . $api_key,
'Content-Type: application/json'
];
// Create a post
function createPost() {
global $base_url, $headers;
$data = [
'workspace_id' => 12,
'labels' => [5],
'content' => [
[
'text' => 'Hello from PHP!',
'media' => []
]
],
'schedule_type' => 'schedule',
'schedule_for' => [
'date' => '2025-07-04',
'time' => '23:00',
'timezone' => 'Africa/Addis_Ababa'
],
'accounts' => [
[
'id' => 136,
'settings' => [
'for_super_followers_only' => false,
'reply_settings' => 'everyone',
'quote_tweet_id' => null,
'reply' => [
'in_reply_to_tweet_id' => null
],
'community_id' => null,
'share_with_followers': true,
'text' => null
]
]
]
];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $base_url . '/posts');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo 'Post created: ' . $response;
}
createPost();
?>
Next Steps
Now that you’ve made your first API calls, explore these resources:API Reference
Complete documentation for all endpoints and parameters
Error Handling
Learn how to handle API errors and rate limits