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)
Alt Text	Optional (media[].alt_text)
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",
                "alt_text": "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[].alt_text	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 alt_text.

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