Description

n8n-nodes-zernio

An n8n community node for the Zernio API – the professional social media management platform.

Schedule and manage social media posts across multiple platforms:

• 🐦 Twitter/X – Posts, threads, and automation
• 📸 Instagram – Posts, Stories, Reels with Business account support
• 👤 Facebook – Page management and posting
• 💼 LinkedIn – Personal and company page posting
• 🎵 TikTok – Direct video posting with privacy controls
• 📹 YouTube – Videos and Shorts with custom thumbnails
• 🧵 Threads – Meta’s social platform
• 🦋 Bluesky – Decentralized social network
• 📌 Pinterest – Pin to boards
• 🤖 Reddit – Post to subreddits
• ✈️ Telegram – Channel posting
• 📍 Google Business – Business profile posts and reviews
• 👻 Snapchat – Public profile posting

Version History

• 1.0.0 – Initial release with comprehensive Zernio API integration

Installation

From n8n Community Nodes Panel (Recommended)

1. Go to Settings → Community Nodes in your n8n instance
2. Select Install and enter n8n-nodes-zernio
3. Click Install and restart n8n
4. The Zernio node will appear in your node palette

> Note: Also available as n8n-nodes-late for backwards compatibility.

From npm

npm install n8n-nodes-zernio

From Source

git clone https://github.com/zernio-dev/n8n-nodes-zernio.git
cd n8n-nodes-zernio
npm install
npm run build

Prerequisites

1. Zernio Account: Sign up at zernio.com
2. API Key: Generate an API key from your Zernio dashboard
3. Social Accounts: Connect your social media accounts to Zernio profiles

Credentials Setup

1. Add a new credential in n8n
2. Search for “Zernio API”
3. Enter your API key from the Zernio dashboard

Quick Start

1. Create a Profile

Profiles organize your social media accounts by brand, client, or purpose.

{
  "resource": "profiles",
  "operation": "create",
  "name": "Personal Brand",
  "description": "My personal social media accounts",
  "color": "#4ade80"
}

2. Connect Social Accounts

Connect your social media platforms to the profile:

{
  "resource": "connect",
  "operation": "connect",
  "platform": "twitter",
  "profileId": "profile123abc"
}

3. Schedule a Post

Create posts across multiple platforms:

{
  "resource": "posts",
  "operation": "create",
  "content": "Hello, world! #automation",
  "platforms": [
    {"platform": "twitter", "accountId": "twitteraccount123"},
    {"platform": "linkedin", "accountId": "linkedinaccount456"}
  ],
  "scheduledFor": "2024-01-15T16:00:00",
  "timezone": "America/New_York"
}

Supported Operations

Profiles

• List – Get all profiles
• Create – Create new profile (subject to plan limits)
• Update – Update profile details
• Delete – Delete profile (must be empty)

Posts

• List – Get posts with pagination and filters
• Get – Get specific post details
• Create – Schedule or publish posts
• Update – Edit draft/scheduled posts
• Delete – Delete posts (published posts cannot be deleted)
• Retry – Retry failed posts
• Logs – Get publishing logs for a post
• Bulk Upload – Upload multiple posts at once

Media

• Upload – Upload images/videos up to 5GB
• Presign – Get presigned URL for large file uploads

Social Accounts

• List – View connected accounts
• Get – Get specific account details
• Update – Update account settings (e.g., display name)
• Delete – Disconnect accounts
• Health – Check account connection health
• All Health – Check health of all accounts
• Follower Stats – Get follower statistics

Account Groups

• List – Get all account groups
• Get – Get specific group details
• Create – Create new account group
• Update – Update group settings
• Delete – Delete account group

Connect Platform

• Connect – Initiate OAuth for new platforms

Usage Statistics

• Get Stats – Monitor usage against plan limits

Analytics

• Get – Get post analytics across platforms
• YouTube Daily Views – Get daily view statistics for YouTube

Queue (Scheduling Slots)

• List – Get queue slots for a profile
• Create – Create new queue slot
• Update – Update slot time
• Delete – Remove queue slot
• Preview – Preview upcoming scheduled posts
• Next Slot – Get next available slot time

Webhooks

• Get – Get webhook configuration
• Create – Create new webhook endpoint
• Update – Update webhook settings
• Delete – Remove webhook
• Test – Send test webhook event
• Logs – View webhook delivery history

Facebook Management

• List Pages – Get available Facebook pages
• Select Page – Connect specific page
• List Account Pages – Get pages for a specific account
• Update Page – Change active page

LinkedIn Management

• Update Organization – Switch between personal/company posting

Google Business Management

• List Locations – Get available business locations
• Select Location – Connect specific location
• List Account Locations – Get locations for an account
• Switch Location – Change active location
• List Reviews – Get business reviews
• Reply Review – Respond to a review
• Delete Reply – Remove review response

Pinterest Management

• List Boards – Get available Pinterest boards
• Select Board – Connect specific board

Bluesky Management

• Connect – Connect Bluesky account with credentials
• Disconnect – Disconnect Bluesky account

Reddit Management

• List Subreddits – Get saved subreddits for posting
• Update Subreddits – Update subreddit list
• Search – Search for subreddits
• Feed – Get subreddit feed (hot, new, top, rising)

Snapchat Management

• List Profiles – Get available public profiles
• Select Profile – Connect specific profile

Telegram Management

• Get Status – Check Telegram connection status
• Initiate – Start Telegram connection flow

Clone Connection

• Clone Connection – Reuse OAuth across profiles

Team Management

• Invites: Create – Invite team members with profile access

API Keys

• List – Get all API keys
• Create – Generate new API key
• Delete – Revoke API key

Users

• List – Get team members
• Get – Get user details

Logs

• List – Get publishing logs with filters
• Get – Get specific log entry

Advanced Features

Platform-Specific Settings

#### Twitter/X Threads
Create multi-tweet threads:

{
  "platforms": [
    {
      "platform": "twitter",
      "accountId": "twitteraccount123",
      "platformSpecificData": {
        "threadItems": [
          {"content": "Tweet 1 - Introduction"},
          {"content": "Tweet 2 - Details"},
          {"content": "Tweet 3 - Conclusion"}
        ]
      }
    }
  ]
}

#### Instagram Stories
Post to Instagram Stories:

{
  "platforms": [
    {
      "platform": "instagram",
      "accountId": "instagramaccount123",
      "platformSpecificData": {
        "contentType": "story"
      }
    }
  ],
  "mediaItems": [
    {"type": "image", "url": "https://your-story-image.jpg"}
  ]
}

#### TikTok Privacy, Photo Carousel and Disclosure Settings

Control TikTok privacy plus optional PHOTO carousel media type (with background
music), commercial content disclosure, and AIGC labeling:

{
  "platforms": [
    {
      "platform": "tiktok",
      "accountId": "tiktokaccount123",
      "platformSpecificData": {
        "tiktokSettings": {
          "privacylevel": "PUBLICTO_EVERYONE",
          "allow_comment": true,
          "allow_duet": true,
          "allow_stitch": true,
          "media_type": "PHOTO",
          "autoaddmusic": true,
          "commercialcontenttype": "brand_organic",
          "isbrandorganic_post": true,
          "videomadewith_ai": false
        }
      }
    }
  ]
}

PHOTO carousel posts require mediatype: "PHOTO" and support autoadd_music
to attach TikTok-recommended background music. Brand and AIGC disclosures are
optional but required by TikTok policy when applicable.

#### YouTube Settings
Add custom thumbnails and first comments:

{
  "platforms": [
    {
      "platform": "youtube",
      "accountId": "youtubeaccount123",
      "platformSpecificData": {
        "firstComment": "Thanks for watching! Don't forget to like and subscribe!"
      }
    }
  ],
  "mediaItems": [
    {
      "type": "video",
      "url": "https://your-video.mp4",
      "thumbnail": "https://your-custom-thumbnail.jpg"
    }
  ],
  "tags": ["tutorial", "automation", "n8n"]
}

#### Bluesky Threads
Create multi-post threads on Bluesky:

{
  "platforms": [
    {
      "platform": "bluesky",
      "accountId": "blueskyaccount123",
      "platformSpecificData": {
        "threadItems": [
          {"content": "Post 1 - Introduction"},
          {"content": "Post 2 - Details"},
          {"content": "Post 3 - Conclusion"}
        ]
      }
    }
  ]
}

Media Upload

Upload files before using in posts:

{
  "resource": "media",
  "operation": "upload",
  "files": [
    {
      "filename": "image.jpg",
      "data": "base64encodeddata"
    }
  ]
}

For large files (>4MB), use the presign operation:

{
  "resource": "media",
  "operation": "presign",
  "filename": "video.mp4",
  "contentType": "video/mp4"
}

Webhooks

Set up webhooks to receive real-time notifications:

{
  "resource": "webhooks",
  "operation": "create",
  "url": "https://your-server.com/webhook",
  "events": ["post.published", "post.failed"]
}

Available webhook events:

• post.scheduled – Post scheduled
• post.published – Post published successfully
• post.failed – Post failed to publish
• post.partial – Post partially published (some platforms failed)

Platform Requirements

• Instagram: Business account required (Personal/Creator accounts not supported)
• Facebook: Must be admin of Facebook pages
• LinkedIn: Company pages require admin access
• TikTok: Creator account recommended
• YouTube: Channel access required
• Twitter/X: Standard account
• Threads: Standard account
• Bluesky: Standard account (uses app password)
• Pinterest: Business account recommended
• Reddit: Account with posting privileges
• Telegram: Bot token required
• Google Business: Business profile owner/manager access
• Snapchat: Public profile required

Plan Limits

Zernio enforces usage limits based on your plan:

• Free: 10 posts/month, 2 Social Sets – $0/mo
• Build: 120 posts/month, 10 Social Sets – $13/mo (billed yearly)
• Accelerate: Unlimited posts, 50 Social Sets – $33/mo (billed yearly)
• Unlimited: Unlimited posts, Unlimited Social Sets – $667/mo (billed yearly)

Optional add-ons available: Analytics, Comments + DMs

Monitor usage with the Usage Statistics operation.

Error Handling

The node handles various error scenarios:

• 403: Plan limits exceeded
• 401: Invalid API key
• 400: Invalid request data
• 404: Resource not found
• 429: Rate limit exceeded

Check the node output for detailed error messages and upgrade suggestions.

Development

Prerequisites

• Node.js 18+
• TypeScript
• n8n development environment

Setup

git clone https://github.com/zernio-dev/n8n-nodes-zernio.git
cd n8n-nodes-zernio
npm install
npm run build

Linting

npm run lint        # Check for issues
npm run lintfix     # Fix automatically

Support

• Documentation: Zernio API Docs
• Dashboard: zernio.com/dashboard
• Email: miki@zernio.com
• Issues: GitHub Issues

License

MIT

Contributing

Contributions are welcome! Please read our contributing guidelines and submit pull requests.

—

Made with love by the Zernio team

Website | Documentation | Dashboard