n8n-nodes-bulkpublish

n8n community node for BulkPublish — publish to 15 social media platforms from your n8n workflows.

Supported Platforms

Facebook, Instagram, X (Twitter), TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business Profile, LinkedIn, Mastodon, Discord, Telegram, Tumblr, Snapchat

The node also accepts reddit, and channels already connected to it keep
publishing — but new Reddit connections are paused pending Reddit API approval,
so it is not counted above.

Installation

In your n8n instance:

1. Go to Settings > Community Nodes
2. Enter n8n-nodes-bulkpublish
3. Click Install

Or via CLI:

npm install n8n-nodes-bulkpublish

Credentials

1. Sign up at app.bulkpublish.com
2. Go to Settings > Developer and create an API key
3. In n8n, add a BulkPublish API credential with your key

The key inherits the role of the member who created it, and the API enforces
that role. A viewer key can read but cannot write, so every create, update
and delete operation here answers 403 for one. A contributor key writes
posts, media and labels but cannot connect or disconnect a channel, and any
recurring schedule it creates or edits is held for team approval — every
occurrence lands in the approval queue whatever the request asks for. Use an
owner, admin or approver key for a workflow that must publish on its own.

Operations

Post

• Create — Create a draft or scheduled post to one or more channels (supports all post types: reels, stories, carousels, threads via postTypeOverrides)
• Get — Get a post with platform statuses
• List — List posts with filters (status, search, date)
• Update — Update a draft or scheduled post
• Delete — Delete a post
• Publish — Publish a draft immediately
• Retry — Retry failed platforms
• Metrics — Get engagement metrics (impressions, likes, comments, shares) — see Reading metrics safely
• Story Publish — Publish as a story to Facebook or Instagram
• Bulk Operations — Bulk delete or retry multiple posts
• Queue Slot — Get the next optimal time slot for a channel

Channel

• List — List all connected social media channels
• Get — Get a channel by ID
• Health Check — Check channel token health
• Get Options — Get platform-specific options (Pinterest boards, YouTube playlists)
• Mentions Search — Search users for @mention (X, Bluesky)

Channel Set

• Create — Save a named group of channels for one-click targeting (max 50 sets per organization; names are unique — duplicates return a 409 DUPLICATE_NAME error)
• List — List channel sets
• Update — Rename a set or change its channels
• Delete — Delete a channel set

Media

• Upload — Upload an image or video file
• Upload Large File — Chunked multipart upload for large files (videos up to 1GB, images up to 100MB). The file is sent in 10MB parts; each part is retried independently, so a network drop never restarts the whole file. Note: the whole file is buffered in n8n memory before upload — make sure your n8n instance has enough RAM for the file size.
• Get — Get a media file by ID
• List — List uploaded media files
• Delete — Delete a media file

Label

• Create — Create a label
• List — List all labels
• Update — Update a label name or color
• Delete — Delete a label

Analytics

• Summary — Get analytics summary for a date range
• Engagement — Get engagement data grouped by time period

Schedule

• List — List recurring schedules
• Create — Create a recurring schedule (frequency + time of day)
• Update — Update a schedule
• Delete — Delete a schedule

RSS Feed

• Create — Add an RSS/Atom feed for autoposting (polled every 15 min; new items become posts). mode defaults to draft (items land as drafts for review); set publish to auto-publish. Max 20 feeds per organization. Optional Field Mapping (JSON) controls how items render (caption template with item tokens, media selection, HTML stripping, truncation, hashtags, per-channel overrides).
• List — List RSS feeds (includes lastCheckedAt and lastError)
• Update — Change name, URL, channels, mode, or enabled. Changing the feed URL re-baselines the feed — only items newer than the change are posted.
• Delete — Delete an RSS feed

Quota

• Usage — Get current plan limits and usage

Reading metrics safely

Every metric column is stored as an integer defaulting to 0, so a 0 does
not always mean zero engagement — it may mean the platform has no such metric
at all. Branch on the support fields, not on the number.

• Post → Metrics returns metricsSupported and supportedMetrics on each
  platform entry. A key absent from supportedMetrics is not a measurement.
• Analytics → Engagement returns supportedTotals (the union across the
  window — treat a total* field whose key is missing as "not available"),
  metricSupport (per-platform lists), partialTotals (platforms excluded from
  an otherwise-real total) and conditionalMetrics (supported but
  permission-gated).

¹ Facebook's impressions/reach/clicks come from Page Insights and need the
read_insights permission; without it they stay 0.

engagementRate is derived from impressions, so it is always 0 where
impressions are unsupported (Bluesky, Mastodon).

Two other legitimate zeroes: figures come from a snapshot refreshed every 6
hours (a just-published post starts at zero), and X's per-post sync is opt-in
per channel and runs at most weekly because X bills every read — affected
channels are listed in metricsDisabledChannels.

Example Workflows

Auto-post RSS feed items

1. RSS Feed Trigger → reads new items
2. BulkPublish → creates a scheduled post for each item

Post on GitHub release

1. GitHub Trigger → new release event
2. BulkPublish → creates and publishes announcement to all channels

Links

• API Docs
• SDK & Examples
• npm
• PyPI

License

MIT