Description

n8n-nodes-pinflow-pinterest

n8n community node package for PinFlow Pinterest, LinkedIn, Instagram, Facebook, TikTok, and media automation.

What this node does

Resource: Media

• Upload Image -> POST /pins/upload-image

This lets you take binary image data from a previous n8n node, upload it into PinFlow storage, and get back the hosted PinFlow image URL for later publishing steps.

Resource: Pin

• Schedule -> POST /pins
• Get -> GET /pins/{id}
• List -> GET /pins
• Delete -> DELETE /pins/{id}

The pin create operation now supports three publish modes:

• Publish Instantly -> queued immediately for publishing
• Schedule -> requires scheduled_at
• Save as Draft -> stores the pin without publishing

Important:

• Every Pinterest pin operation now takes an explicit Pinterest Profile ID
• This prevents accidental publishing to the wrong connected Pinterest account when one PinFlow workspace has multiple Pinterest profiles
• Pinterest profile, board, and linked social account fields now load as dropdowns from your PinFlow account
• Pinterest board choices are filtered by the selected Pinterest profile

Resource: Board

• List -> GET /boards?pinterestprofileid=...

This lets you first fetch boards for a specific Pinterest profile, then schedule pins to a selected board.

Resource: Instagram Account

• List -> GET /instagram/profiles

Resource: LinkedIn Profile

• List -> GET /auth/linkedin/profiles

Resource: LinkedIn Target

• List -> GET /linkedin/targets

Resource: LinkedIn Post

• Create -> POST /linkedin/posts
• Get -> GET /linkedin/posts/{id}
• List -> GET /linkedin/posts
• Publish -> POST /linkedin/posts/{id}/publish
• Delete -> DELETE /linkedin/posts/{id}

List operations can now be filtered by LinkedIn Profile ID.

Resource: Instagram Post

• Create -> POST /instagram/posts
• Get -> GET /instagram/posts/{id}
• List -> GET /instagram/posts
• Publish -> POST /instagram/posts/{id}/publish
• Delete -> DELETE /instagram/posts/{id}

List operations can now be filtered by Instagram Profile ID.

Resource: Facebook Page

• List -> GET /facebook/pages

Resource: Facebook Post

• Create -> POST /facebook/posts
• Get -> GET /facebook/posts/{id}
• List -> GET /facebook/posts
• Publish -> POST /facebook/posts/{id}/publish
• Delete -> DELETE /facebook/posts/{id}

List operations can now be filtered by Facebook Page ID.

Resource: TikTok Profile

• List -> GET /tiktok/profiles

Resource: TikTok Post

• Create -> POST /tiktok/posts
• Get -> GET /tiktok/posts/{id}
• List -> GET /tiktok/posts
• Publish -> POST /tiktok/posts/{id}/publish
• Delete -> DELETE /tiktok/posts/{id}

List operations can now be filtered by TikTok Profile ID.

Credentials

Create PinFlow API credentials in n8n:

• Base URL: example https://pinflow.agency
• API Key: from PinFlow dashboard -> API Keys

Auth header used by the node:

Authorization: Bearer

Required PinFlow setup

• Account must be on a plan with API enabled.
• Account must not be billing locked.
• At least one Pinterest profile must be linked in PinFlow.
• For LinkedIn posting, at least one LinkedIn account must be linked in PinFlow.
• For Instagram posting, at least one Instagram account must be linked in PinFlow.
• For Facebook posting, at least one Facebook Page must be linked in PinFlow.
• For TikTok posting, at least one TikTok creator account must be linked in PinFlow.

Example workflow (Auto schedule)

1. Trigger (Cron or Manual)
2. Previous node provides binary image data
3. PinFlow node: Resource Media, Operation Upload Image, set Input Binary Field
4. Read the returned url
5. PinFlow node: Resource Pin, Operation Create
6. Choose the Pinterest Profile ID from the dropdown
7. Choose the Board ID from the dropdown filtered to that profile
8. Fill media_url with the uploaded PinFlow URL, then title, description, and link
9. Choose Publish Mode:
– Publish Instantly to queue it now
– Schedule and provide scheduled_at
– Save as Draft to keep it unpublished

Example workflow (Upload image only)

1. Trigger (Manual)
2. Binary-producing node (for example, Read Binary File, HTTP download, or image generation node)
3. PinFlow node: Resource Media, Operation Upload Image
4. Set Input Binary Field to the binary property name, usually data
5. Use returned url in later Pinterest, Instagram, or Facebook steps

Example workflow (LinkedIn publish)

1. Trigger (Cron or Manual)
2. PinFlow node: Resource LinkedIn Profile, Operation List
3. PinFlow node: Resource LinkedIn Target, Operation List
4. Pick linkedinprofileid, targettype, and targeturn
5. PinFlow node: Resource LinkedIn Post, Operation Create
6. Fill text, mediatype, optional mediaurl, and status

Example workflow (Instagram publish)

1. Trigger (Cron or Manual)
2. PinFlow node: Resource Instagram Account, Operation List
3. Pick one id from the output
4. PinFlow node: Resource Instagram Post, Operation Create
5. Fill instagramprofileid, mediatype, mediaurl, caption, and status

Example workflow (Facebook publish)

1. Trigger (Cron or Manual)
2. PinFlow node: Resource Facebook Page, Operation List
3. Pick one id from the output
4. PinFlow node: Resource Facebook Post, Operation Create
5. Fill facebookpageid, message, mediatype, mediaurl if needed, optional title for video, and status

Example workflow (TikTok publish)

1. Trigger (Cron or Manual)
2. PinFlow node: Resource TikTok Profile, Operation List
3. Pick one id from the output
4. PinFlow node: Resource TikTok Post, Operation Create
5. Fill tiktokprofileid, mediaurl, privacylevel, caption, consent, and status

Notes:

• TikTok requires a public video URL
• privacy_level must be valid for the connected TikTok creator account
• consent_confirmed must be true for queued or scheduled publishing

Development

cd n8n-nodes-pinflow
npm install
npm run build

Publish to npm

For n8n Creator Portal submission, publish from the standalone public GitHub repository using the provenance-enabled workflow documented in RELEASING.md. Do not publish verified releases manually from a local terminal.

npm login
npm publish --access public --otp=123456

The manual command above is only for local package testing or legacy releases. It does not create the GitHub provenance required by n8n.

Install in n8n

1. Go to Settings -> Community Nodes
2. Click Install
3. Enter package name: n8n-nodes-pinflow-pinterest

Ready-to-import workflow templates

Importable Pinterest, multi-network image, and multi-network video workflows are available in templates/. The official n8n Creator Hub submission steps and prepared listing copy are in templates/PUBLISHING.md.