Description

n8n-nodes-mixpost

This is an n8n community node that lets you integrate Mixpost with your n8n workflows.

Mixpost is a self-hosted social media management software that helps you schedule and manage your social media content across multiple platforms including Facebook, Twitter/X, Instagram, LinkedIn, Pinterest, TikTok, YouTube, and more.

n8n is a workflow automation platform.

🚀 Installation

Automatic – From n8n UI (Recommended)

1. Navigate to Settings → Community Nodes in your n8n instance
2. Click Install
3. Enter n8n-nodes-mixpost in the package name field
4. Click Install to add it to your n8n instance

Manual – Command Line Installation

Use this method if your n8n instance doesn’t support installation through the in-app GUI.

#### Docker Installation

Access your Docker container:

docker exec -it containername> sh

Create ~/.n8n/nodes if it doesn’t already exist, and navigate into it:

mkdir ~/.n8n/nodes
cd ~/.n8n/nodes
npm init -y

Install the Mixpost node package:

npm install n8n-nodes-mixpost

Restart your n8n instance to load the new node.

#### Non-Docker Installation

Navigate to ~/.n8n, and check if a custom folder exists. If not, create it, then add a new package.json file inside.

mkdir -p ~/.n8n/custom
npm init -y

Then, install the Mixpost node package:

npm install n8n-nodes-mixpost

Restart n8n to load the new node.

📋 Operations

📝 Posts

| Operation | Description |
|———–|————-|
| Create | Create a new social media post with content, media, and scheduling options |
| Get | Retrieve a specific post by UUID |
| Get Many | Retrieve multiple posts with filtering by status, account, or tags |
| Update | Replace a post’s accounts, tags, versions and schedule. Anything left out is removed, so send the whole post |
| Delete | Delete a single post |
| Delete Bulk | Delete multiple posts at once |
| Schedule | Schedule a post at its current time or at a new one, optionally with its own time for some accounts, or publish it now |
| Add to Queue | Add a post to the publishing queue |
| Approve | Approve a post for publishing |
| Retry Account | Publish a post again to an account where it failed |

🏢 Workspaces

| Operation | Description |
|———–|————-|
| Get Many | List the workspaces your access token can reach, with your role in each |

👥 Accounts

| Operation | Description |
|———–|————-|
| Get | Retrieve details of a specific social media account |
| Get Many | List the connected social media accounts in your workspace, filtered by keyword, platform, group or lost connection |

📈 Analytics

| Operation | Description |
|———–|————-|
| Get Summary | Workspace analytics for a period: followers, growth, posts, audience chart and leaderboard (reference) |
| Get Account Analytics | One type of analytics of an account — overview, content, insights and more, depending on the provider (reference) |
| Get Post Analytics | How a published post performed on each account it went out to (reference) |
| Get Posting Times | The best weekdays and hours to post, learned from past posts (reference) |
| Get Best Times | The next best date and time to post for each account (reference) |

Analytics periods and dates are UTC days, and a custom range may span at most 366 days. Posting times and best times are given in the requested timezone.

🖼️ Media

| Operation | Description |
|———–|————-|
| Upload | Upload images or videos, optionally filed into a folder and with alt text |
| Get | Retrieve a specific media file by UUID |
| Get Many | List media files, filtered by folder, type, keyword, usage or favourites |
| Update | Update a media file’s name, alt text, or the folder it is filed in |
| Delete | Delete media files by ID or UUID, up to 500 per request |

📁 Media Folders

| Operation | Description |
|———–|————-|
| Create | Create a folder, at the root or inside another |
| Get Many | Retrieve the whole folder tree, with parents and file counts |
| Update | Rename a folder or move it under another |
| Delete | Delete a folder, keeping or deleting the files inside it |

🏷️ Tags

| Operation | Description |
|———–|————-|
| Create | Create a new tag with name and color |
| Get | Retrieve a specific tag by UUID |
| Get Many | List all tags in your workspace |
| Update | Update tag properties (name, color) |
| Delete | Delete a tag from your workspace |

🔑 Credentials Setup

Prerequisites

1. A running Mixpost instance on the latest Mixpost Pro v7 or Mixpost Enterprise v8. Version 1.0 of this node does not support older Mixpost versions.
2. Admin access to generate API tokens

Steps to Configure

1. Generate API Token in Mixpost:
– Read the Mixpost API documentation to learn how to generate an API token.
2. Configure in n8n:
– In n8n, go to Overview → Create Workflow
– Open nodes panel
– Search for “Mixpost”
– Add an Mixpost action to your workflow
– Click on Credentials → Create new credential
– Enter the following:
– Mixpost URL: Your Mixpost instance URL with core path (e.g., https://mixpost.yourdomain.com/mixpost)
– Access Token: The token you generated in step 1
– Click Save

🔧 Workspace UUID

Every operation except Workspace → Get Many works in one workspace. Pick it in the Workspace field:

• From List — choose from the workspaces your access token can reach, searchable by name.
• By UUID — paste a UUID, or map one from an expression. Workspace → Get Many returns the uuid of each workspace.

📊 Supported Social Platforms

Mixpost supports posting to:

• ✅ Facebook Pages
• ✅ X
• ✅ Instagram (Business accounts)
• ✅ Threads
• ✅ LinkedIn (Profiles & Pages)
• ✅ Pinterest
• ✅ TikTok
• ✅ YouTube
• ✅ Google Business Profile
• ✅ Mastodon
• ✅ Bluesky

⚙️ Advanced Features

Pagination

When using “Get Many” operation for post or media resource, you can control pagination:

• Per Page Limit: Set how many results to return per page (default is 50, max is 100)

Filtering

Posts can be filtered by:

• Status: draft, scheduled, published, failed
• Account ID: Filter by specific social account
• Tag: Filter by tag name
• Page: Navigate through paginated results

Media can be filtered by:

• Folder: A folder UUID, or root for files filed in no folder
• Type: image, gif, video
• MIME Types: Exact MIME types, as a comma-separated list
• Keyword: Matches the file name. A search reaches the whole library, so it overrides Folder and Favorite.
• Usage: published, scheduled, draft, unused
• Favorite: Only the files the token’s user has starred
• Sort: newest, oldest, name, size

🛠️ Development

Prerequisites

• Node.js 18+
• npm or yarn
• TypeScript knowledge

Setup Development Environment

Clone the repository
git clone https://github.com/inovector/n8n-nodes-mixpost.git
cd n8n-nodes-mixpost
Install dependencies
npm install
Build the node
npm run build
Run in development mode (watch for changes)
npm run dev
Run linter
npm run lint
Format code with Prettier
npm run format
Run tests (if available)
npm test

📚 Resources

• n8n Community Nodes Documentation
• Mixpost Documentation
• Mixpost API Reference
• n8n Workflow Examples
• Report Issues

📄 License

MIT License

🤝 Support

Need help? Here’s how to get support:

1. Documentation First: Check the Mixpost docs
2. GitHub Issues: Report bugs or request features
3. Mixpost Community: Join our community channels for help and discussions:
– 💬 Discord Server – Real-time chat support
– 🐦 Facebook Group – Latest updates and announcements
4. n8n Community: Ask in the n8n community forum

🎯 Contributing

We welcome contributions! Here’s how you can help:

Ways to Contribute

• 🐛 Report bugs
• 💡 Suggest new features
• 📝 Improve documentation
• 🔧 Submit pull requests

Development Workflow

1. Fork the repository
2. Clone your fork: git clone https://github.com/YOUR_USERNAME/n8n-nodes-mixpost.git
3. Create a feature branch: git checkout -b feature/amazing-feature
4. Make your changes and test thoroughly
5. Commit with clear messages: git commit -m 'Add amazing feature'
6. Push to your fork: git push origin feature/amazing-feature
7. Open a Pull Request with a detailed description

Code Standards

• Follow existing code style
• Update documentation as needed
• Run npm run format & npm run lint before submitting

🙏 Acknowledgments

• The n8n team for the amazing workflow automation platform
• The Mixpost team behind the coolest self-hosted social media management tool
• All contributors who help improve this node

—

Made with ❤️ by Inovector

Star ⭐ this repository if you find it helpful!