# 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

<table><thead><tr><th width="196.09722900390625">Feature</th><th>Details</th></tr></thead><tbody><tr><td>Max Media</td><td>1 video or up to 5 photos</td></tr><tr><td>Supported Formats</td><td>JPEG, PNG, GIF, MP4</td></tr><tr><td>Link URL</td><td>External links only (use <code>url</code> field)</td></tr><tr><td>Alt Text</td><td>Optional (<code>media[].alt_text</code>)</td></tr><tr><td>Board Selection</td><td>Use <code>accounts[].album_id</code> to pick a Pinterest board</td></tr></tbody></table>

### Request Structure

```json
{
  "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

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

### 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](https://publer.com/docs/posting/create-posts/content-types/platform-specific-formats)
* [Publishing Methods](https://publer.com/docs/posting/create-posts/publishing-methods)
* [Content Types](https://publer.com/docs/posting/create-posts/content-types)