n8n

Connect PostPost to 400+ apps using n8n's HTTP Request node.

Overview

n8n is a free, self-hostable workflow automation platform. Use the HTTP Request node to call the PostPost API and automate your social media posting.

Prerequisites

n8n instance (cloud or self-hosted)
PostPost API key from app.postpost.dev
At least one social account connected in PostPost

Setting Up Credentials

Create PostPost Header Auth

In n8n, go to Credentials
Click Add Credential
Select Header Auth
Configure:
- Name: PostPost API
- Header Name: x-api-key
- Header Value: YOUR_API_KEY
Save

Example 1: Post When Notion Page Created

Automatically share new Notion pages to social media.

Workflow Setup

Notion Trigger → Database Item Created
HTTP Request → POST to PostPost

HTTP Request Configuration

URL:

https://api.postpost.dev/api/v1/create-post

Method: POST

Authentication: Header Auth (PostPost API)

Body (JSON):

{
  "content": "📝 New article: {{ $json.properties.Name.title[0].plain_text }}\n\nRead it here: {{ $json.url }}",
  "platforms": ["twitter-123456789", "linkedin-ABC123DEF"]
}

Example 2: Content Calendar from Airtable

Use Airtable as your content calendar and auto-schedule posts.

Airtable Base Structure

Content	Platforms	Scheduled Time	Status	Post ID
Monday tip!	twitter-123;linkedin-456	2026-03-01T09:00:00Z	pending

Workflow Setup

Schedule Trigger → Every hour
Airtable → List Records (filter: Status = "pending", Scheduled Time <= now + 1 hour)
Loop Over Items
Function → Split platforms string into array
HTTP Request → POST to PostPost
Airtable → Update Record (set status to "scheduled")

Function Node: Split Platforms

const platforms = $input.first().json.fields.Platforms.split(';').map(p => p.trim());

return [{
  json: {
    ...$input.first().json,
    platformsArray: platforms
  }
}];

HTTP Request Configuration

URL:

https://api.postpost.dev/api/v1/create-post

Body (JSON):

{
  "content": "{{ $json.fields.Content }}",
  "platforms": {{ $json.platformsArray }},
  "scheduledTime": "{{ $json.fields['Scheduled Time'] }}"
}

Example 3: Auto-Post from RSS Feed

Share new blog posts automatically.

Workflow Setup

RSS Feed Read → Check every 15 minutes
IF → Check if item is new (compare with stored IDs)
HTTP Request → POST to PostPost
Code → Store processed item IDs

HTTP Request Configuration

URL:

https://api.postpost.dev/api/v1/create-post

Body (JSON):

{
  "content": "🆕 {{ $json.title }}\n\n{{ $json.contentSnippet.substring(0, 200) }}...\n\nRead more: {{ $json.link }}",
  "platforms": ["twitter-123456789", "linkedin-ABC123DEF"]
}

Example 4: Scheduled Posts from Google Sheets

Workflow Setup

Google Sheets Trigger → Row Added
Date & Time → Parse scheduled time
IF → Check if scheduled time is in future
HTTP Request → POST to PostPost
Google Sheets → Update Row (mark as scheduled)

Code Node: Prepare Post Data

const row = $input.first().json;

// Split platforms by semicolon
const platforms = row['Platforms'].split(';').map(p => p.trim());

// Ensure valid ISO 8601 format
const scheduledTime = new Date(row['Scheduled Time']).toISOString();

return [{
  json: {
    content: row['Content'],
    platforms: platforms,
    scheduledTime: scheduledTime
  }
}];

HTTP Request Configuration

URL:

https://api.postpost.dev/api/v1/create-post

Body (JSON):

{
  "content": "{{ $json.content }}",
  "platforms": {{ $json.platforms }},
  "scheduledTime": "{{ $json.scheduledTime }}"
}

Example 5: Multi-Platform Post with Different Content

Post tailored content to each platform.

Workflow Setup

Webhook → Receive trigger with content
Switch → Branch by platform
Multiple HTTP Request nodes (one per platform)

Branch: Twitter (Short form)

{
  "content": "{{ $json.shortContent }}\n\n{{ $json.link }}",
  "platforms": ["twitter-123456789"]
}

Branch: LinkedIn (Long form)

{
  "content": "{{ $json.longContent }}\n\n{{ $json.link }}\n\n#business #technology",
  "platforms": ["linkedin-ABC123DEF"]
}

Branch: Threads (Medium form)

{
  "content": "{{ $json.mediumContent }}\n\n{{ $json.link }}",
  "platforms": ["threads-987654321"]
}

Example 6: Upload Image and Post

Upload an image first, then create a post with it.

Workflow Setup

Trigger (e.g., Webhook with file URL)
HTTP Request → Create post to get a postGroupId
HTTP Request → GET upload URL from PostPost (with postGroupId)
HTTP Request → Download image from source
HTTP Request → PUT upload to S3 (media auto-attaches via postGroupId)

Step 2: Create Post

URL:

https://api.postpost.dev/api/v1/create-post

Method: POST

Body:

{
  "content": "Check out this image!",
  "platforms": ["twitter-123456789"]
}

Step 3: Get Upload URL

URL:

https://api.postpost.dev/api/v1/get-upload-url

Method: POST

Body:

{
  "fileName": "{{ $json.fileName }}",
  "contentType": "{{ $json.contentType }}",
  "postGroupId": "{{ $node['Create Post'].json.postGroupId }}"
}

Step 5: Upload to S3

URL: {{ $node["Get Upload URL"].json.uploadUrl }}

Method: PUT

Headers:

Content-Type: {{ $json.contentType }}

Body: Binary data from previous download node

Note: Media is automatically attached to the post via the postGroupId provided when requesting the upload URL. No need to pass media references when creating the post.

Example 7: Weekly Content Schedule

Post recurring content every week.

Workflow Setup

Schedule Trigger → Every Monday at 9 AM
Code → Generate weekly content array
Loop Over Items
Wait → Stagger posts by day
HTTP Request → POST to PostPost

Code Node: Generate Weekly Content

const baseDate = new Date();
baseDate.setUTCHours(9, 0, 0, 0);

const weeklyContent = [
  { content: 'Monday motivation: Start your week with purpose!', dayOffset: 0 },
  { content: 'Tech tip Tuesday: Version your APIs for stability.', dayOffset: 1 },
  { content: 'Wednesday wisdom: Ship fast, iterate faster.', dayOffset: 2 },
  { content: 'Throwback Thursday: How we reached 10K users.', dayOffset: 3 },
  { content: 'Feature Friday: Check out our new dashboard!', dayOffset: 4 },
];

return weeklyContent.map(item => {
  const scheduledDate = new Date(baseDate);
  scheduledDate.setDate(scheduledDate.getDate() + item.dayOffset);

  return {
    json: {
      content: item.content,
      platforms: ['twitter-123456789', 'linkedin-ABC123DEF'],
      scheduledTime: scheduledDate.toISOString()
    }
  };
});

Example 8: Slack Command to Post

Let your team schedule social posts from Slack.

Workflow Setup

Webhook → Receive Slack slash command
Code → Parse command and extract content
HTTP Request → POST to PostPost
HTTP Request → Respond to Slack

Code Node: Parse Slack Command

const text = $input.first().json.text;

// Parse: /post twitter,linkedin Hello world!
const match = text.match(/^(\S+)\s+(.+)$/);

if (!match) {
  return [{
    json: {
      error: true,
      message: 'Usage: /post twitter,linkedin Your post content'
    }
  }];
}

const platformMap = {
  'twitter': 'twitter-123456789',
  'linkedin': 'linkedin-ABC123DEF',
  'threads': 'threads-987654321'
};

const platforms = match[1].split(',')
  .map(p => platformMap[p.trim().toLowerCase()])
  .filter(Boolean);

return [{
  json: {
    content: match[2],
    platforms: platforms
  }
}];

Error Handling

Add Error Workflow

Create a separate error handling workflow
In your main workflow settings, set the error workflow
Handle common errors:

const statusCode = $input.first().json.statusCode;
const error = $input.first().json.error || $input.first().json.message;

let action = 'retry';
let message = '';

switch (statusCode) {
  case 401:
    action = 'alert';
    message = 'Invalid API key. Check your PostPost credentials.';
    break;
  case 403:
    action = 'alert';
    message = 'Access denied: ' + error;
    break;
  case 400:
    action = 'skip';
    message = 'Invalid request: ' + error;
    break;
  case 429:
    action = 'retry';
    message = 'Rate limited. Will retry in 60 seconds.';
    break;
  case 500:
    action = 'retry';
    message = 'Server error. Will retry.';
    break;
  default:
    action = 'alert';
    message = 'Unknown error: ' + error;
}

return [{ json: { action, message, statusCode } }];

Common Error Responses

Status	Meaning	Solution
400	Bad request	Check JSON syntax and required fields
401	Unauthorized	Verify API key in credentials
404	Not found	Check platform IDs exist
429	Rate limited	Add Wait node between requests

Useful Code Snippets

Split Platforms String

const platforms = $json.platforms.split(';').map(p => p.trim());
return [{ json: { ...($json), platformsArray: platforms } }];

Truncate for Twitter

const content = $json.content;
const truncated = content.length > 250
  ? content.substring(0, 247) + '...'
  : content;
return [{ json: { ...($json), twitterContent: truncated } }];

Format Date for Scheduling

const dateString = $json.date;
const isoDate = new Date(dateString).toISOString();
return [{ json: { ...($json), scheduledTime: isoDate } }];

Check Response Success

const response = $input.first().json;

if (!response.success) {
  throw new Error(response.error || response.message || 'Post creation failed');
}

return [{ json: { postGroupId: response.postGroupId } }];

Get Platform Connection IDs

One-Time Lookup Workflow

Manual Trigger
HTTP Request → GET platform connections
Code → Format output

HTTP Request:

GET https://api.postpost.dev/api/v1/platform-connections

Code Node:

const connections = $input.first().json.connections;

console.log('Platform IDs:');
connections.forEach(conn => {
  console.log(`  ${conn.platform}: ${conn.platformId} (${conn.username})`);
});

return connections.map(conn => ({ json: conn }));

Best Practices

Use Header Auth credential - Store your API key securely in n8n credentials
Add Wait nodes - Add 200ms+ delay between API calls to avoid rate limits
Error workflows - Set up error handling for failed requests
Test first - Use n8n's manual execution to test before activating
Environment variables - Store platform IDs in workflow variables
Logging - Add Code nodes to log important events

Recommended Workflow Variables

// Set in workflow settings
const platformIds = {
  twitter: 'twitter-123456789',
  linkedin: 'linkedin-ABC123DEF',
  threads: 'threads-987654321',
  instagram: 'instagram-456789012'
};

PostPost — Social media API with free tier, paid plans from $2.99/account

On this page