Description

n8n-nodes-robinreach

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

Schedule and manage social media posts across 10+ platforms:

• Twitter/X
• Instagram
• Facebook
• LinkedIn
• TikTok
• YouTube
• Threads
• Pinterest
• Bluesky
• Google My Business

Version History

• 1.0.0 – Initial release with comprehensive RobinReach 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-robinreach
3. Click Install and restart n8n
4. The RobinReach node will appear in your node palette

From npm

npm install n8n-nodes-robinreach

From Source

git clone https://github.com/RobinReach/RobinReach-N8N.git
cd RobinReach-N8N
npm install
npm run build

Prerequisites

1. RobinReach Account: Sign up at robinreach.com
2. Bloom or Thrive Plan: API access requires paid plan
3. API Key: Generate from your RobinReach dashboard
4. Social Accounts: Connect your social media accounts to RobinReach

Credentials Setup

1. Add a new credential in n8n
2. Search for “RobinReach API”
3. Enter your API key from the RobinReach dashboard
4. Select environment (Production/Development)

Quick Start

1. List Your Brands

Get all your RobinReach brands/companies:

{
  "operation": "listBrands"
}

2. Get Connected Social Profiles

List social media accounts connected to a brand:

{
  "operation": "listSocialProfiles",
  "brandId": "brand123abc"
}

3. Create and Publish a Post

Create posts across multiple platforms:

{
  "operation": "createPost",
  "brandId": "brand123abc",
  "content": "Hello, world! 🌍 #automation",
  "socialProfileIds": ["profile123", "profile456"],
  "publishType": "publish_now",
  "platformSettings": {
    "facebook": {
      "postType": "post",
      "comment": "Check out our latest update! 🚀"
    },
    "instagram": {
      "postType": "post",
      "comment": "Check out our latest update! 🚀"
    }
  }
}

Supported Operations

Brands Management

• List Brands – Get all your RobinReach brands/companies

Social Profiles

• List Social Profiles – Get connected social media accounts for a brand

Posts Management

• Create Post – Create and publish/schedule/draft posts

Advanced Features

Platform-Specific Settings

#### Facebook Settings

{
  "platformSettings": {
    "facebook": {
      "postType": "post",
      "comment": "Auto-comment after posting..."
    }
  }
}

#### Instagram Settings

{
  "platformSettings": {
    "instagram": {
      "postType": "post",
      "comment": "What do you think? Let me know below! 👇"
    }
  }
}

#### Twitter/X Settings

{
  "platformSettings": {
    "twitter": {
      "replies": ["Follow-up tweet for thread", "Another reply in the thread"]
    }
  }
}

Media Attachments

Add media via URLs:

{
  "operation": "createPost",
  "content": "Check out this amazing content!",
  "mediaUrls": [
    "https://your-domain.com/image1.jpg",
    "https://your-domain.com/video1.mp4"
  ]
}

Scheduling Posts

Schedule posts for optimal engagement:

{
  "operation": "createPost",
  "publishType": "schedule",
  "scheduledDate": "2024-12-25",
  "scheduledTime": "09:00",
  "timezone": "America/New_York"
}

Labels and Organization

Organize posts with labels:

{
  "operation": "createPost",
  "content": "Holiday promotion post",
  "labels": ["holiday", "promotion", "december"]
}

Platform Requirements

• Instagram: Business account recommended for advanced features
• Facebook: Page admin access required
• LinkedIn: Company page admin access for business posting
• TikTok: Creator account recommended
• YouTube: Channel access required
• Twitter/X: Standard account
• Pinterest: Business account recommended
• Threads: Meta account required
• Bluesky: Standard account
• Google My Business: Business profile admin access required

Plan Limits

RobinReach enforces usage limits based on your plan:

• Bloom Plan: Advanced features, API access
• Thrive Plan: Full API access, unlimited automation
• Enterprise: Custom limits and features

Monitor your usage through the RobinReach dashboard.

Error Handling

The node handles various error scenarios:

• 401: Invalid API key or authentication failed
• 403: Plan limits exceeded or insufficient permissions
• 400: Invalid request data or missing parameters
• 404: Resource not found (brand, profile, post)
• 429: Rate limit exceeded

Check the node output for detailed error messages and solutions.

Workflow Examples

Daily Automated Posts

Create a workflow that posts daily content:

1. Schedule Trigger – Daily at 9 AM
2. RobinReach: List Brands – Get your brands
3. RobinReach: List Social Profiles – Get connected accounts
4. RobinReach: Create Post – Create daily content

RSS to Social Media

Convert blog posts to social media content:

1. RSS Feed Read – Monitor your blog
2. RobinReach: Create Post – Create social posts
3. Multiple Platforms – Automatic cross-posting

Content Repurposing

Repurpose content across platforms:

1. Webhook Trigger – New content alert
2. RobinReach: Create Post – Platform-optimized posting

Development

Prerequisites

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

Setup

git clone https://github.com/RobinReach/RobinReach-N8N.git
cd RobinReach-N8N
npm install
npm run build

Linting

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

Support

• Documentation: RobinReach API Docs
• Dashboard: robinreach.com
• Email: support@robinreach.com
• Issues: GitHub Issues

License

MIT

Contributing

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

—

Made with 💙 by the RobinReach team

Website • Documentation