Actions87
- Users Actions
- Shopping & Catalogs Actions
- Advertising & Campaigns Actions
- Advanced Analytics Actions
- Engagement Features Actions
- Business Tools Actions
- Search & Discovery Actions
- Pins Actions
- Boards Actions
Overview
The "Create Pin" operation in the Pinterest resource allows users to create a new pin on a specified Pinterest board. This node is useful for automating content publishing workflows where images or videos need to be pinned programmatically, such as scheduling marketing posts, curating visual content collections, or managing brand presence on Pinterest.
Typical use cases include:
- Automatically creating pins from an image or video URL or base64 data.
- Adding descriptive titles, descriptions, and links to pins for better engagement.
- Organizing pins into specific boards and board sections.
- Creating repins by specifying a parent pin ID.
- Adding notes to pins for additional context.
Example: A marketing automation workflow that creates pins with promotional images and links to product pages on a Pinterest board every time a new product is added to an e-commerce catalog.
Properties
| Name | Meaning |
|---|---|
| Board ID | The identifier of the Pinterest board where the pin will be created (required). |
| Title | The title of the pin (required, max length 100 characters). |
| Description | Optional description text for the pin (max length 800 characters). |
| Link | Optional URL link associated with the pin, typically pointing to a related webpage or product. |
| Media Source Type | The type of media source used for the pin's content. Options: Image URL, Video URL, Image Base64, Video Base64. |
| Media Source URL | The URL of the media (image or video) when using Image URL or Video URL as the media source type. |
| Media Source Data | Base64 encoded media data when using Image Base64 or Video Base64 as the media source type. |
| Board Section ID | Optional ID of a board section within the board to organize the pin further. |
| Parent Pin ID | Optional ID of a parent pin to create a repin (repost) of an existing pin. |
| Note | Optional note text attached to the pin for additional information. |
Output
The output JSON contains the response from the Pinterest API after creating the pin. It includes details about the newly created pin such as its ID, title, description, link, media source information, board association, and any other metadata returned by the API.
If the operation succeeds, the output item’s json field holds the pin object data. There is no binary data output for this operation.
Dependencies
- Requires an active subscription and valid API key for the external "N8N Tools API" service, which acts as a proxy or middleware for Pinterest API calls.
- Requires OAuth2 credentials for Pinterest API access.
- The node uses internal helper classes to interact with various Pinterest API endpoints.
- Proper configuration of these credentials in n8n is necessary before executing the node.
Troubleshooting
- Invalid Subscription or API Key: If the N8N Tools API validation fails with 401 or 403 errors, verify that your API key and subscription are active and correctly configured.
- Missing Required Fields: Ensure all required properties like Board ID and Title are provided; otherwise, the API call will fail.
- Media Source Mismatch: When selecting a media source type, provide the corresponding media data or URL. For example, if "Image URL" is selected, the "Media Source URL" must be set.
- API Rate Limits: Frequent calls may hit Pinterest API rate limits; consider adding delays or error handling for rate limit responses.
- Permission Errors: Some operations require elevated access or specific permissions on the Pinterest account or board.
Links and References
- Pinterest API Documentation
- Pinterest Create Pin Endpoint
- n8n Documentation on Credentials
- Base64 Encoding Guide
This summary is based solely on static analysis of the provided source code and property definitions.