Description

n8n-nodes-postoo

An n8n community node for publishing social-media posts through Postoo.

The node can publish to any supported social account connected in Postoo, including LinkedIn, Facebook, Instagram, TikTok, Bluesky, Pinterest, Threads, and YouTube. Account availability depends on the connections enabled in your Postoo workspace.

Installation

On a self-hosted n8n instance:

1. Open Settings → Community Nodes.
2. Select Install.
3. Enter n8n-nodes-postoo.
4. Confirm the installation and restart n8n if prompted.

Credentials

1. In Postoo, open Settings → API Keys and create an API key.
2. In n8n, create a Postoo API credential.
3. Paste the API key.
4. Keep the default base URL, https://postoo.pl/api/v1, unless you use a preview or self-hosted Postoo instance.
5. Select Save. n8n tests the credential against GET /accounts.

n8n stores credential values encrypted. Treat the API key as a secret and revoke it in Postoo if it is exposed.

Operations

Post → Publish

Publishes one post to one connected social account using POST /publish.

• Social Account Name or ID: Choose a connected account or provide its Postoo account ID with an expression.
• Content: Plain-text post content, up to 5,000 characters.
• Media URL: Optional public image or video URL.
• Idempotency Key: Optional 8 to 128 character key. Use a stable value derived from your source record and target account for correlation and forward compatibility. The current Postoo API does not yet guarantee durable replay or deduplication.

Keep n8n’s Retry On Fail setting disabled for this operation. The node refuses to start a publish while that setting is enabled because an automatic retry after an ambiguous provider outcome can create a duplicate post.

For the same reason, publishing is blocked when the node runs as an AI Agent tool. Use a regular workflow step so a human-controlled workflow decides how to handle an ambiguous result.

When the node receives multiple input items, set On Error to continue with per-item output. The node blocks a multi-item publish otherwise: if a later item failed, n8n could discard an earlier successful result and a rerun could publish that earlier item twice.

The operation returns the external post ID, platform, and publication status.

Account → List

Lists the social accounts connected to the Postoo workspace using GET /accounts. This is useful for dynamic fan-out workflows and for resolving account IDs before publishing.

Example workflow

[Trigger] → [Prepare content]
          → [Postoo: Publish to LinkedIn]
          → [Postoo: Publish to Facebook]
          → [Postoo: Publish to Instagram]
          → [Postoo: Publish to TikTok]

Use a stable idempotency key derived from your source record and target account, such as post-{{$json.id}}-{{$json.accountId}}. Do not automatically retry an ambiguous publication: the current API can return an unknown outcome without a durable operation to replay.

Errors and rate limits

Postoo errors are returned in English with a stable code and request ID where available. Common codes include:

• invalidapikey
• ratelimitexceeded
• accountnotfound
• account_inactive
• account_disconnected
• publish_rejected
• publishfailedunknown

publishfailedunknown means Postoo cannot confirm whether the provider accepted the post. Do not retry automatically. First inspect the destination account at the social provider; a blind retry can create a duplicate post.

The node also reports an unknown outcome when Postoo returns an unrecognized publish error code or an incomplete success response without a valid external post ID, platform, and status.

For an unrecognized structured error, the diagnostic retains the original code as providerCode and includes requestId when Postoo supplies one.

Default API limits:

• Publish requests: 60 per hour for each API key.
• Account and post reads: 120 per minute for each API key.

Development

npm ci
npm run lint
npm test
npx @n8n/scan-community-package n8n-nodes-postoo

Releases are published from GitHub Actions with npm provenance. Local npm publish is intentionally not part of the release process.

See CHANGELOG.md for release history.

License

MIT