> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dohoo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest Posting API: Create Pins | Dohoo

> Use the Dohoo Pinterest posting API to publish images, titles, and descriptions to connected Pinterest boards.

The Pinterest Publish endpoint lets you create pins on any board within a connected Pinterest account. Provide a file reference, a target board ID, and optional title and description fields, and Dohoo posts the pin to Pinterest on your behalf. Because Pinterest operates as a visual search engine, well-crafted titles and descriptions directly influence how discoverable your pins are over time.

## Endpoint

```
POST https://dohoo.ai/api/v2/pinterest/publish
```

## Request headers

| Header         | Required | Description                |
| -------------- | -------- | -------------------------- |
| `X-API-Key`    | ✅        | Your Dohoo API key         |
| `Content-Type` | ✅        | Must be `application/json` |

## Request body

| Field          | Type   | Required | Description                                        |
| -------------- | ------ | -------- | -------------------------------------------------- |
| `connectionId` | string | ✅        | The ID of the Pinterest connection to publish from |
| `fileId`       | string | ✅        | The ID of the uploaded image file                  |
| `title`        | string | ❌        | Title of the pin. Maximum 100 characters           |
| `description`  | string | ❌        | Description of the pin. Include keywords for SEO   |
| `boardId`      | string | ✅        | The ID of the Pinterest board to pin to            |

## Example request

```bash theme={null}
curl -X POST https://dohoo.ai/api/v2/pinterest/publish \
  -H "X-API-Key: dh_live_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "connectionId": "conn_pinterest_001",
    "fileId": "abc123",
    "title": "Pin title",
    "description": "Pin description with keywords for SEO",
    "boardId": "your-board-id"
  }'
```

## Example response

```json theme={null}
{
  "success": true,
  "platform": "pinterest",
  "pinId": "1234567890123456789",
  "connectionId": "conn_pinterest_001",
  "boardId": "your-board-id",
  "status": "published",
  "publishedAt": "2025-01-15T13:10:00Z",
  "url": "https://www.pinterest.com/pin/1234567890123456789"
}
```

<Tip>
  Pinterest is a **search-driven platform** — pins have a long shelf life and continue to surface in search results months or years after publishing. Include relevant keywords naturally in both the `title` and `description` fields to maximize organic reach over time.
</Tip>

<Note>
  You can find your `boardId` by navigating to the target board in Pinterest and copying the ID from the URL: `https://www.pinterest.com/username/board-name/` — or by listing boards via the Dohoo connections dashboard.
</Note>

<Tip>
  Pinterest recommends a **2:3 aspect ratio** (e.g. 1000×1500 px) for standard pins. Vertical images consistently outperform square or landscape formats in Pinterest feeds.
</Tip>