Ship your first Pin in five minutes.

# Verify your key — list connected Pinterest accounts
curl https://api.pinbridge.io/v1/pinterest/accounts \
  -H "X-API-Key: $PINBRIDGE_API_KEY"

# Returns a Pinterest consent URL to redirect the user to
curl https://api.pinbridge.io/v1/pinterest/oauth/start \
  -H "X-API-Key: $PINBRIDGE_API_KEY"

curl -X POST https://api.pinbridge.io/v1/pins \
  -H "X-API-Key: $PINBRIDGE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_id": "acc_xxx",
    "board_id": "board_xxx",
    "image_url": "https://cdn.shop/img/1.jpg",
    "title": "Summer styles 2026",
    "idempotency_key": "summer-2026-001"
  }'

# pip install pinbridge-sdk
from pinbridge_sdk import PinbridgeClient
from pinbridge_sdk.models import PinCreate

client = PinbridgeClient(api_key=PINBRIDGE_API_KEY)

pin = client.pins.create(PinCreate(
    account_id=ACCOUNT_ID,
    board_id=BOARD_ID,
    title='Summer styles 2026',
    image_url='https://cdn.shop/img/1.jpg',
    idempotency_key='summer-2026-001',
))
print(pin.status)  # queued

{
  "event": "pin.published",
  "pin_id": "pin_8fa2",
  "board_id": "b_78f2a9",
  "status": "published"
}