Skip to main content

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.

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

HeaderRequiredDescription
X-API-Key✅Your Dohoo API key
Content-Type✅Must be application/json

​
Request body

FieldTypeRequiredDescription
connectionIdstring✅The ID of the Pinterest connection to publish from
fileIdstring✅The ID of the uploaded image file
titlestring❌Title of the pin. Maximum 100 characters
descriptionstring❌Description of the pin. Include keywords for SEO
boardIdstring✅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.