Overview
Pinterest API covers pins, boards, media, analytics for users + business accounts. The Automize Pinterest connector covers these.
- Regions: Global.
- Plans: Free.
Setting up the connection
Auth type: OAuth 2.0 (Authorization Code).
- Pinterest Developers → create app → OAuth credentials.
- In Automize → Settings → Connectors → Pinterest. Paste credentials.
Find your credentials at https://developers.pinterest.com/.
Rate limits
Per-app.
Data model
Pinterest primitives:
User ─── Boards ─── Pins
└─ Sections
Media (uploads)
AnalyticsAvailable operations
8 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Create Board | General | Create a new board |
| Create Pin | General | Create a new pin |
| Delete Pin | General | Delete a pin |
| Get Account | General | Get the authenticated user account |
| Get Board | General | Get board details by ID |
| Get Pin | General | Get pin details by ID |
| List Boards | General | List boards for the authenticated user |
| List Pins | General | List pins on a board |
Operations
Create Board
Create a new board
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Description description | Yes | text | |
Privacy privacy | Yes | text |
Create Pin
Create a new pin
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text | |
Title title | Yes | text | |
Description description | Yes | text | |
Media Source media_source | Yes | text | |
Link link | Yes | text |
Tips
- board_id + image (url or upload) + title + description + link.
Delete Pin
Delete a pin
| Parameter | Required | Type | Description |
|---|---|---|---|
Pin Id pin_id | Yes | text |
Get Account
Get the authenticated user account
No input parameters.
Get Board
Get board details by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
Get Pin
Get pin details by ID
| Parameter | Required | Type | Description |
|---|---|---|---|
Pin Id pin_id | Yes | text |
List Boards
List boards for the authenticated user
No input parameters.
Tips
- Owned boards. Filter by privacy.
List Pins
List pins on a board
| Parameter | Required | Type | Description |
|---|---|---|---|
Board Id board_id | Yes | text |
Tips
- Per board. Or user-wide.
FAQ
- Personal vs Business?
- Business accounts get analytics + ads. Personal accounts: basic create/read.