Pinterest Posting API: Create Pins

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

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

{
  "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"
}

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.

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.

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.

Overview

Files & Folders

Publishing

Pinterest Posting API: Create Pins | Dohoo

Endpoint

Request headers

Request body

Example request

Example response

​Endpoint

​Request headers

​Request body

​Example request

​Example response

Endpoint

Request headers

Request body

Example request

Example response