PinBridge for n8n

The PinBridge community node lets you publish, schedule, and manage Pinterest pins from any n8n workflow, without writing code. This page explains what the node is, how to install it, and where to go next.

What the node is

n8n-nodes-pinbridge is a community node package (version 1.2.12). It ships a single action node called PinBridge that talks to the PinBridge API on your behalf. One node covers 8 resources:

• Asset — upload images and videos to PinBridge storage.
• Board — list, create, and delete Pinterest boards.
• Connection — list and manage connected Pinterest accounts.
• Pin — publish pins, check status, and run bulk imports.
• Rate Meter — read your live rate-limit budget.
• Schedule — queue pins to publish at a future time.
• Term — look up related keywords for a Pinterest account.
• Webhook — register delivery URLs for pin events.

There is no trigger node in this package. To react to pin events (pin.published, pin.failed) inside n8n, you use n8n’s built-in Webhook node and register its URL with PinBridge. See Receive pin events with a webhook.

Prerequisites

• An n8n instance (self-hosted 1.0.0 or later, or n8n Cloud).
• A PinBridge account with a Pinterest account connected.
• A PinBridge API key (create one in your project settings).

The Free (Playground) plan works for publishing from public image URLs. Uploading assets and running bulk imports require a paid plan. See Bulk import pins and Upload images and video for the exact plan gates.

Install on self-hosted n8n

1. Open n8n and go to Settings → Community nodes.
2. Choose Install a community node.
3. Enter the package name n8n-nodes-pinbridge and confirm.
4. n8n installs the package and the PinBridge node appears in the node panel.

You can also install from the command line inside your n8n environment:

npm install n8n-nodes-pinbridge

Install on n8n Cloud

The PinBridge node is a verified community node, so it installs on n8n Cloud the same way:

1. Open Settings → Community nodes in your Cloud instance.
2. Choose Install a community node, enter n8n-nodes-pinbridge, and confirm.

No self-hosting is required. The node runs inside your Cloud instance.

Credential setup, in short

The node authenticates with a single credential type, PinBridge API Key (pinBridgeApi). It has two fields:

• Base URL (baseUrl) — defaults to https://api.pinbridge.io. Change it only if you run a self-hosted PinBridge API.
• API Key (apiKey) — your key, sent in the X-API-Key header.

When you save the credential, n8n runs a test call against GET /v1/pinterest/accounts to confirm the key works. Full walkthrough: Set up your PinBridge credential.

Where to go next

• Set up your PinBridge credential — connect your API key and pass the credential test.
• Publish your first pin — a step-by-step flow from an image URL.
• Node reference — every resource, operation, parameter, and endpoint.
• Troubleshooting — fixes for credential, publish, and event-receiving errors.