Pinterest Pins With a Link URL

Share visually engaging Pins with an external link URL to drive traffic from Pinterest boards.

Overview

Create or schedule a Pinterest Pin by setting type: "photo", adding your media, specifying url for the external link, and the album_id to select the destination board.

Key Features

• Single API call to schedule or publish…
• Supports up to 5 photos or 1 video per Pin
• Clickable external URL
• Specify the target board with album_id
• Optional alt text for accessibility

Supported Features & Limits

Feature	Details
Max Media	1 video or up to 5 photos
Supported Formats	JPEG, PNG, GIF, MP4
Link URL	External links only (use url field)
Caption	Optional (media[].caption)
Board Selection	Use accounts[].album_id to pick a Pinterest board

Request Structure

{
  "bulk": {
    "state": "scheduled",
    "posts": [
      {
        "networks": {
          "pinterest": {
            "type": "photo",
            "text": "Check out our new blog post!",
            "media": [
              {
                "id": "external-0",
                "type": "photo",
                "path": "https://cdn.example.com/images/post1.jpg",
                "thumbnail": "https://cdn.example.com/images/post1-thumb.jpg",
                "caption": "Screenshot of our blog homepage"
              }
            ],
            "title": "Our Latest Blog Article",
            "url": "https://publer.com/blog"
          }
        },
        "accounts": [
          {
            "id": "YOUR_PINTEREST_ACCOUNT_ID",
            "scheduled_at": "2025-07-05T14:16:00+02:00",
            "album_id": "934145216398624390"
          }
        ]
      }
    ]
  }
}

Parameters

Field	Type	Description
networks.pinterest.type	string	Must be "photo".
networks.pinterest.text	string	Caption or description for the Pin.
networks.pinterest.media	array	List of media objects (1 video or up to 5 photos).
networks.pinterest.media[].id	string	"external-X" or media ID from Publer.
networks.pinterest.media[].path	string	URL to the full-size image or video.
networks.pinterest.media[].thumbnail	string	URL to the thumbnail image.
networks.pinterest.media[].type	string	Must be "photo" or "video".
networks.pinterest.media[].caption	string	Accessible description of the image (optional).
networks.pinterest.title	string	Pin title displayed on hover.
networks.pinterest.url	string	Clickable external link URL.
accounts[].id	string	Pinterest account identifier.
accounts[].album_id	string	Board ID where the Pin will be posted.
accounts[].scheduled_at	string	ISO 8601 timestamp for scheduling (omit to publish immediately).

Workflow

1. Select Account & Board Add your Pinterest account.id and target album_id.
2. Upload/Reference Media Upload up to 5 photos or 1 video to Publer, then reference each with its id.
3. Compose Pin

   • Set type: "photo".
   • Provide text, title, and url.
   • Optionally add caption.
4. Schedule or Publish

   • To schedule, include scheduled_at.
   • To publish now, call /posts/schedule/publish or omit scheduled_at.

Best Practices

• Use high-resolution images or video for best display.
• Keep the title and text concise to encourage clicks.
• Ensure the URL is valid and leads to valuable content.
• Organize Pins into relevant Boards for better discoverability.
• Add alt text for accessibility and SEO benefits.

Related Topics

• Platform-Specific Formats
• Publishing Methods
• Content Types