n8n-nodes-postzee

This is an n8n community node that allows you to use Postzee in your n8n workflows.

Postzee is a powerful AI-powered social media management platform that allows you to create, schedule, and automate your social media content — including AI image generation, carousel creation from templates, and multi-platform publishing.

n8n is a fair-code licensed workflow automation platform.

Installation

Follow the installation guide in the n8n community nodes documentation.

Quick Installation

1. Go to Settings in your n8n instance
2. Click on Community Nodes
3. Click on Install
4. Enter n8n-nodes-postzee in the npm Package Name field
5. Click Install

Manual Installation (without Docker)

Go to your n8n installation directory (usually ~/.n8n):

cd ~/.n8n/custom
npm install n8n-nodes-postzee

Installation with Docker

Create a folder for custom nodes and install the package:

mkdir -p ~/n8n-custom-nodes
cd ~/n8n-custom-nodes
npm init -y
npm install n8n-nodes-postzee

Then mount the folder when running n8n:

docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -e N8N_CUSTOM_EXTENSIONS="~/n8n-custom-nodes" \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Operations

The Postzee node supports the following operations:

Content Creation

• Generate Media with AI — Generate one or more images using AI models (Nano Banana, GPT Image, Ideogram, etc.). Returns a jobId for status polling.
• Generate from Template — Generate images or carousels from a Postzee template. Aspect ratio is determined automatically from the template. Supports 4 modes:
  • AI generates everything — Provide a prompt, AI creates all texts and images. Use contentSlides to control how many times the model slide is cloned (0 = use template default layout).
  • Manual texts + AI images — You provide texts, AI generates the images. Use contentSlides to control model slide cloning.
  • Manual texts + external images — You provide texts and image URLs (no AI cost). Number of slides is determined by the slots you provide.
  • Fully manual — You provide all content, Postzee just assembles the template. Number of slides is determined by the slots you provide.

Status & Monitoring

• Job Status — Check the status of any generation job (image or carousel). Returns completion status and media URLs when ready. Use this in a loop to poll until generation is complete.

Publishing

• Create Post — Schedule or immediately publish posts to 30+ social media platforms (Instagram, LinkedIn, X, TikTok, Facebook, and more)
• Delete Post — Delete a scheduled or published post by ID

Media & Channels

• Upload File — Upload media files (images/videos) to your Postzee library
• Get Channels — Get a list of your connected social media channels
• Get Posts — Get a list of your scheduled/published posts

Workflow Examples

Generate AI Image → Post to Instagram

[Postzee: Generate Media] → [Wait 10s] → [Postzee: Job Status] → [IF success] → [Postzee: Create Post]

1. Generate Media — Model: Nano Banana, Prompt: "A sunset over mountains", Quantity: 1
2. Wait — 10 seconds (AI generation time)
3. Job Status — Job ID: {{$json.jobId}}
4. IF — Check {{$json.status}} equals success
   • Yes → Create Post with {{$json.medias[0].id}} and {{$json.medias[0].path}}
   • No → Loop back to Wait (or handle error if status === "failed")

Generate Carousel from Template → Post

[Postzee: Generate from Template] → [Wait 30s] → [Postzee: Job Status] → [IF complete] → [Postzee: Create Post]

1. Generate from Template — Select template, Mode: AI generates everything, Prompt: "7 productivity tips"
2. Wait — 30 seconds (multiple images being generated)
3. Job Status — Job ID: {{$json.jobId}}
4. IF — Check {{$json.status}} equals complete
   • Yes → Create Post with all medias from {{$json.medias}}
   • No → Loop back to Wait

Automated Daily Content Pipeline

[Schedule Trigger] → [Generate from Template] → [Wait] → [Job Status Loop] → [Create Post to Multiple Platforms]

Job Status Response

The Job Status operation returns a unified response format:

{
  "jobId": "abc-123",
  "jobType": "task",
  "status": "success",
  "medias": [
    {
      "id": "media-uuid",
      "path": "https://cdn.postzee.app/image.jpg",
      "type": "image"
    }
  ]
}

For carousel/batch jobs:

{
  "jobId": "group-456",
  "jobType": "group",
  "status": "complete",
  "completed": 7,
  "total": 7,
  "medias": [
    { "id": "media-1", "path": "https://cdn.postzee.app/slide1.jpg", "type": "image", "order": 0 },
    { "id": "media-2", "path": "https://cdn.postzee.app/slide2.jpg", "type": "image", "order": 1 }
  ]
}

Status values:

• processing — Generation in progress
• success — Single media completed
• complete — All medias in group completed
• failed — Generation failed (check error field)

Supported Platforms

Instagram, Facebook, LinkedIn, X (Twitter), TikTok, YouTube, Pinterest, Threads, Bluesky, Reddit, Mastodon, Discord, Slack, Medium, Dev.to, Hashnode, and more.

Credentials

You need to obtain an API key from your Postzee account:

1. Log in to your Postzee account
2. Go to Settings → API
3. Generate a new API key
4. Copy and paste it into the n8n credential configuration

Compatibility

• Requires n8n version 0.199.0 or higher
• Node.js 20.15 or higher

Resources

• n8n community nodes documentation
• Postzee Website
• Postzee Dashboard

Support

For issues or questions:

• Create an issue in this repository
• Contact Postzee support at [email protected]

License

MIT