n8n-nodes-wrldwide-social

This is an n8n community node for posting to social media platforms via the WRLDWIDE API.

Features

• Post text and media to multiple social platforms simultaneously
• Supported platforms: Twitter/X, Facebook, Instagram, LinkedIn, TikTok, YouTube, Bluesky, Threads, Pinterest, Reddit, Telegram, Snapchat, Google Business
• Schedule posts for future publishing
• YouTube video posting with required title field

Prerequisites

1. A WRLDWIDE account with a paid subscription (Art Director, Data Analyst, or Growth Specialist tier)
2. Social media accounts connected in your WRLDWIDE dashboard
3. A WRLDWIDE API key (generate from Settings > API Keys)

Installation

For self-hosted n8n

1. Navigate to your n8n installation directory
2. Install the package:

   npm install n8n-nodes-wrldwide-social

3. Restart n8n

Manual Installation

1. Clone or download this repository
2. Run npm install to install dependencies
3. Run npm run build to compile TypeScript
4. Run npm run build:icons to copy icon assets to dist
5. Run npm link to create a global link
6. Navigate to your n8n custom nodes directory (~/.n8n/custom/)
7. Run npm link n8n-nodes-wrldwide-social
8. Restart n8n

Configuration

1. In n8n, go to Credentials and create a new "WRLDWIDE API" credential
2. Enter your API key (starts with wrld_)
3. The default API URL is pre-configured but can be changed if needed

Usage

Post to Social Media

1. Add the "WRLDWIDE Social Post" node to your workflow
2. Select your WRLDWIDE API credentials
3. Configure the post:
   • Text: The content of your post (character limits vary by platform)
   • Platforms: Select one or more platforms to post to
   • Media URLs: Optional comma-separated list of publicly accessible media URLs
   • YouTube Title: Required when posting to YouTube (max 100 characters)
   • Schedule Date: Optional future date/time for scheduled posting

Character Limits by Platform

| Platform | Limit | | --------------- | ----- | | Twitter/X | 280 | | Bluesky | 300 | | Threads | 500 | | Pinterest | 500 | | Snapchat | 500 | | Telegram | 1024 | | Google Business | 1500 | | Instagram | 2200 | | TikTok | 2200 | | LinkedIn | 3000 | | Reddit | 5000 | | YouTube | 5000 | | Facebook | 63206 |

API Response

Successful posts return:

{
  "status": "success",
  "postId": "uuid",
  "ayrsharePostId": "string",
  "platforms": {
    "twitter": "post_id",
    "instagram": "post_id"
  },
  "scheduled": false
}

Error Handling

The node will throw errors for:

• Missing API credentials
• No platforms selected
• Empty post (no text or media)
• YouTube posts without a title
• YouTube title exceeding 100 characters
• Disconnected platforms
• API rate limits

Use the "Continue On Fail" option to handle errors gracefully in your workflow.

Support

For issues with the WRLDWIDE API, contact [email protected]

License

MIT