Pinterest Integration

Field	Description	Required	Format
Access Token	Your Pinterest OAuth access token	Yes	`-`

Field	Description	Required	Format
App ID	Your Pinterest App ID from the developer portal	Yes	`-`
App Secret	Your Pinterest App Secret from the developer portal	Yes	`-`

list_boards — List all Pinterest boards for the authenticated user

Parameters

integer

Number of boards per page (max 250) (Default: 25)

string

Cursor for pagination to get the next page

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "boards": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Boards",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "bookmark": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bookmark"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListBoardsOutput",
  "type": "object"
}

get_board_sections — Get sections of a Pinterest board to organize pins

Parameters

string

required

The ID of the board to get sections from

integer

Number of sections per page (max 250) (Default: 25)

string

Cursor for pagination

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "board_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Board Id"
    },
    "sections": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Sections",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "bookmark": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bookmark"
    }
  },
  "required": [
    "success"
  ],
  "title": "GetBoardSectionsOutput",
  "type": "object"
}

create_pin — Create a new pin on a Pinterest board with an image URL

Parameters

string

required

The ID of the board to pin to

string

required

Title of the pin

string

required

URL of the image to pin

string

Description of the pin

string

Source link/URL for the pin

string

Alt text for accessibility

string

ID of the board section

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Id"
    },
    "title": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Title"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Description"
    },
    "link": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Link"
    },
    "board_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Board Id"
    },
    "board_section_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Board Section Id"
    },
    "created_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Created At"
    },
    "pin": {
      "anyOf": [
        {
          "additionalProperties": true,
          "type": "object"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Pin"
    }
  },
  "required": [
    "success"
  ],
  "title": "CreatePinOutput",
  "type": "object"
}

list_pins — List pins from a Pinterest board or board section

Parameters

string

required

The ID of the board to list pins from

string

ID of the board section (optional)

integer

Number of pins per page (max 250) (Default: 25)

string

Cursor for pagination

Response

{
  "additionalProperties": false,
  "properties": {
    "success": {
      "title": "Success",
      "type": "boolean"
    },
    "error": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Error"
    },
    "board_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Board Id"
    },
    "board_section_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Board Section Id"
    },
    "pins": {
      "items": {
        "additionalProperties": true,
        "type": "object"
      },
      "title": "Pins",
      "type": "array"
    },
    "count": {
      "default": 0,
      "title": "Count",
      "type": "integer"
    },
    "bookmark": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Bookmark"
    }
  },
  "required": [
    "success"
  ],
  "title": "ListPinsOutput",
  "type": "object"
}

Using

Providers

Building

Tools

Pinterest Integration for AI Agents & Workflows

Overview

Authentication

OAuth Access Token

Required Credentials

OAuth 2.0

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Klaviyo

ServiceNow

Telegram Bot

Links

​Overview

​Authentication

​OAuth Access Token

​Required Credentials

​OAuth 2.0

​Required Credentials

​OAuth Configuration

​Available Actions

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Parameters

​Response

​Limits & Quotas

​Related integrations

Klaviyo

ServiceNow

Telegram Bot

​Links

Overview

Authentication

OAuth Access Token

Required Credentials

OAuth 2.0

Required Credentials

OAuth Configuration

Available Actions

Parameters

Response

Parameters

Response

Parameters

Response

Parameters

Response

Limits & Quotas

Related integrations

Links