n8n-nodes-pinflow-pinterest
v0.1.13
Published
n8n community node for PinFlow publishing and media upload across Pinterest, LinkedIn, Instagram, Facebook, and TikTok
Maintainers
Readme
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 /pinsGet->GET /pins/{id}List->GET /pinsDelete->DELETE /pins/{id}
The pin create operation now supports three publish modes:
Publish Instantly-> queued immediately for publishingSchedule-> requiresscheduled_atSave 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?pinterest_profile_id=...
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/postsGet->GET /linkedin/posts/{id}List->GET /linkedin/postsPublish->POST /linkedin/posts/{id}/publishDelete->DELETE /linkedin/posts/{id}
List operations can now be filtered by LinkedIn Profile ID.
Resource: Instagram Post
Create->POST /instagram/postsGet->GET /instagram/posts/{id}List->GET /instagram/postsPublish->POST /instagram/posts/{id}/publishDelete->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/postsGet->GET /facebook/posts/{id}List->GET /facebook/postsPublish->POST /facebook/posts/{id}/publishDelete->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/postsGet->GET /tiktok/posts/{id}List->GET /tiktok/postsPublish->POST /tiktok/posts/{id}/publishDelete->DELETE /tiktok/posts/{id}
List operations can now be filtered by TikTok Profile ID.
Credentials
Create PinFlow API credentials in n8n:
Base URL: examplehttps://pinflow.agencyAPI Key: from PinFlow dashboard -> API Keys
Auth header used by the node:
Authorization: Bearer <API_KEY>
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)
- Trigger (
CronorManual) - Previous node provides binary image data
PinFlownode: ResourceMedia, OperationUpload Image, setInput Binary Field- Read the returned
url PinFlownode: ResourcePin, OperationCreate- Choose the
Pinterest Profile IDfrom the dropdown - Choose the
Board IDfrom the dropdown filtered to that profile - Fill
media_urlwith the uploaded PinFlow URL, thentitle,description, andlink - Choose
Publish Mode:Publish Instantlyto queue it nowScheduleand providescheduled_atSave as Draftto keep it unpublished
Example workflow (Upload image only)
- Trigger (
Manual) - Binary-producing node (for example,
Read Binary File, HTTP download, or image generation node) PinFlownode: ResourceMedia, OperationUpload Image- Set
Input Binary Fieldto the binary property name, usuallydata - Use returned
urlin later Pinterest, Instagram, or Facebook steps
Example workflow (LinkedIn publish)
- Trigger (
CronorManual) PinFlownode: ResourceLinkedIn Profile, OperationListPinFlownode: ResourceLinkedIn Target, OperationList- Pick
linkedin_profile_id,target_type, andtarget_urn PinFlownode: ResourceLinkedIn Post, OperationCreate- Fill
text,media_type, optionalmedia_url, andstatus
Example workflow (Instagram publish)
- Trigger (
CronorManual) PinFlownode: ResourceInstagram Account, OperationList- Pick one
idfrom the output PinFlownode: ResourceInstagram Post, OperationCreate- Fill
instagram_profile_id,media_type,media_url,caption, andstatus
Example workflow (Facebook publish)
- Trigger (
CronorManual) PinFlownode: ResourceFacebook Page, OperationList- Pick one
idfrom the output PinFlownode: ResourceFacebook Post, OperationCreate- Fill
facebook_page_id,message,media_type,media_urlif needed, optionaltitlefor video, andstatus
Example workflow (TikTok publish)
- Trigger (
CronorManual) PinFlownode: ResourceTikTok Profile, OperationList- Pick one
idfrom the output PinFlownode: ResourceTikTok Post, OperationCreate- Fill
tiktok_profile_id,media_url,privacy_level,caption, consent, andstatus
Notes:
- TikTok requires a public video URL
privacy_levelmust be valid for the connected TikTok creator accountconsent_confirmedmust betruefor queued or scheduled publishing
Development
cd n8n-nodes-pinflow
npm install
npm run buildPublish to npm
npm login
npm publish --access public --otp=123456If npm enforces publish 2FA, pass your current OTP code.
Install in n8n
- Go to
Settings->Community Nodes - Click
Install - Enter package name:
n8n-nodes-pinflow-pinterest
