Create Pinboard

Create a new pinboard to organize your pins.

Endpoint


POST /v1/pinboards

Authentication

Requires API key with pinboards:write scope.

Request Body

Field	Type	Required	Description
`title`	string	Yes	Pinboard title
`description`	string	No	Pinboard description
`tags`	string[]	No	Tags for organization
`layout`	object	No	Desktop layout configuration
`mobile_layout`	object	No	Mobile layout configuration

Example

Client-JS


import { PindownClient } from '@pindownai/client-js'
 
const client = new PindownClient({
  apiKey: process.env.PINDOWN_API_KEY
})
 
// Create pinboard
const pinboard = await client.pinboards.create({
  title: 'Sales Dashboard',
  tags: ['sales', 'metrics', 'dashboard']
})
 
console.log(`Pinboard created: ${pinboard.id}`)

cURL


curl -X POST https://api.pindown.ai/v1/pinboards \
  -H "Authorization: Bearer pk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Sales Dashboard",
    "tags": ["sales", "metrics"]
  }'

Node.js Fetch


const response = await fetch('https://api.pindown.ai/v1/pinboards', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${process.env.PINDOWN_API_KEY}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    title: 'Sales Dashboard',
    tags: ['sales', 'metrics']
  })
})
 
const result = await response.json()
console.log(`Pinboard created: ${result.data.id}`)

Response


{
  "success": true,
  "data": {
    "id": "pb-abc123",
    "title": "Sales Dashboard",
    "created_at": 1730472600000
  }
}

Rate Limiting

This endpoint costs 2 tokens per request.