Overview
This node integrates with the Pinterest API v5 to create a new pin on a specified Pinterest board. It allows users to add pins by providing details such as title, description, destination link, and an image. The image can be supplied via a direct URL, binary data from previous nodes, or a base64-encoded string.
Common scenarios for this node include automating content curation workflows where images and links are programmatically pinned to Pinterest boards, marketing automation to schedule pins, or integrating Pinterest content creation into larger automation pipelines.
For example, a user could automatically pin newly published blog post images with their URLs and descriptions to a Pinterest board dedicated to that blog's content.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authentication; currently supports OAuth2. |
| Board ID | The unique identifier of the Pinterest board where the pin will be created. (Required) |
| Title | The title of the pin. |
| Description | A description for the pin. |
| Link (Destination URL) | The URL that the pin will link to when clicked. |
| Media Source | The source type of the image to pin. Options: Image URL, Binary Property (Image), Base64 String. |
| Image URL | The URL of the image to pin. Required if Media Source is "Image URL". |
| Binary Property | The name of the binary property containing the image data from previous nodes. Required if Media Source is "Binary Property (Image)". |
| Base64 Image | The base64-encoded image string. Required if Media Source is "Base64 String". |
Output
The node outputs JSON objects representing the created pin as returned by the Pinterest API. The output includes all details of the newly created pin such as its ID, URL, title, description, and media information.
If the image is provided as binary data, the node internally converts it to a base64 string before sending it to the API, but the output remains the JSON response from Pinterest describing the created pin.
Dependencies
- Requires an OAuth2 authentication credential configured in n8n to access the Pinterest API.
- Internet access to call the Pinterest API endpoints.
- Proper permissions/scopes granted to the OAuth2 token to create pins on the user's boards.
Troubleshooting
- Missing Binary Property Error: If using the binary image option, ensure the specified binary property exists and contains valid image data. The error message
"Binary property "<propertyName>" is missing"indicates this issue. - Authentication Errors: Ensure the OAuth2 credentials are correctly set up and have not expired.
- Invalid Board ID: Verify the board ID is correct and accessible by the authenticated user.
- Invalid Image Data: When using base64 or image URL, ensure the image data is valid and accessible.
- API Rate Limits: Pinterest API may limit requests; handle errors accordingly.