Pinterest

Manage pins, boards, and analytics via the Pinterest API.

Detail	Value
Category	Social Media
Base URL	https://api.pinterest.com/v5
Authentication	OAuth2
Endpoints	6
Connector key	pinterest

Using Pinterest in a workflow

1. Go to Connections and click New Connection.
2. Pick Pinterest from the marketplace.
3. Enter your credentials (see Authentication above for what's expected).
4. In a workflow, drop an API Call node and select this connection.
5. Pick the operation you need from the Operation dropdown. The full list is below.

Available endpoints

Endpoint	Summary
GET /user_account	Get user account
POST /pins	Create a pin
GET /pins/{pinId}	Get a pin
GET /boards	List boards
POST /boards	Create a board
GET /user_account/analytics	Get account analytics

Each endpoint is documented in full below. Use the outline on the right to jump to one.

GET /user_account

Get user account

Detail	Value
Operation ID	social.getAccount
Method	GET
Path	/user_account

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.getAccount.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.

POST /pins

Create a pin

Detail	Value
Operation ID	social.createPin
Method	POST
Path	/pins

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.createPin.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.

GET /pins/{pinId}

Get a pin

Detail	Value
Operation ID	social.getPin
Method	GET
Path	/pins/{pinId}

Parameters

Name	Location	Type	Required
pinId	path	string	Yes

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.getPin.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

Required fields are marked: fill them or the call will fail at runtime.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.

GET /boards

List boards

Detail	Value
Operation ID	social.listBoards
Method	GET
Path	/boards

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.listBoards.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.

POST /boards

Create a board

Detail	Value
Operation ID	social.createBoard
Method	POST
Path	/boards

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.createBoard.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.

GET /user_account/analytics

Get account analytics

Detail	Value
Operation ID	social.getAnalytics
Method	GET
Path	/user_account/analytics

Parameters

No parameters.

Using this endpoint in a workflow

1. Add an API Call node to your workflow.
2. Pick your Pinterest connection from the Connection dropdown.
3. In the Operation dropdown, select social.getAnalytics.
4. Fill in the parameter fields that appear. Use {{...}} to reference upstream values.

What it returns

The API Call node writes the response to the workflow context:

{
  status: 200,
  success: true,
  data: { ...response body from the API... },
  latencyMs: 142
}

Reference response fields downstream as {{nodeId.data.path}}. The exact response shape is documented on the upstream Pinterest API reference.