> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest

> Pinterest is a visual discovery platform for finding ideas like recipes, home and style inspiration, and more.

![Pinterest logo](https://mintcdn.com/composio-preview/HvfZXDijhFOaKyF5/images/toolkits/pinterest.svg?fit=max\&auto=format\&n=HvfZXDijhFOaKyF5\&q=85\&s=bdb5ca7b274e52a3d46f804b5ad92820)

* **Category:** social media accounts
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 27
* **Triggers:** 0
* **Slug:** `PINTEREST`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Board
>
> **Slug:** `PINTEREST_CREATE_BOARD`
>
> Create a public or secret Pinterest board. Secret creation requires boards:write\_secret.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Board name (1-50 characters).
>
> **privacy** `string ("PUBLIC" | "SECRET")`
>
> PUBLIC or SECRET. PROTECTED and ad-only boards are outside this Organic toolkit.
>
> **description** `string`
>
> Optional board description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Board Section
>
> **Slug:** `PINTEREST_CREATE_BOARD_SECTION`
>
> Create a named section within a Pinterest board.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Section name (1-180 characters).
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Pin
>
> **Slug:** `PINTEREST_CREATE_PIN`
>
> Create an image, carousel, or registered-video Pin on a Pinterest board. Production execution requires Pinterest Standard access: Trial apps are explicitly blocked from creating Pins on api.pinterest.com and must use a separately authenticated API Sandbox connection.
>
> #### Input Parameters
>
> **link** `string`
>
> Optional destination URL, up to 2048 characters.
>
> **title** `string`
>
> Optional Pin title, up to 100 characters.
>
> **alt\_text** `string`
>
> Optional accessible description, up to 500 characters.
>
> **board\_id** `string` *required*
>
> Numeric ID of the destination Pinterest board.
>
> **description** `string`
>
> Optional Pin description, up to 800 characters.
>
> **media\_source** `string` *required*
>
> Official image URL, image Base64, carousel URL, carousel Base64, or registered-video source. The closed-beta pin\_url source is not supported.
>
> **dominant\_color** `string`
>
> Optional dominant hexadecimal color, for example #6E7874.
>
> **board\_section\_id** `string`
>
> Optional numeric ID of a section within the destination board.
>
> **ai\_disclosure\_values** `array`
>
> Optional creator declarations: AI\_MODIFIED and/or SYNTHETIC\_PERFORMER. Pinterest receives these under ai\_disclosures.values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Board
>
> **Slug:** `PINTEREST_DELETE_BOARD`
>
> Permanently delete a Pinterest board by ID, including a secret board when authorized.
>
> #### Input Parameters
>
> **board\_id** `string` *required*
>
> Numeric ID of the board to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Board Section
>
> **Slug:** `PINTEREST_DELETE_BOARD_SECTION`
>
> Permanently delete a section from a Pinterest board.
>
> #### Input Parameters
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> **section\_id** `string` *required*
>
> Numeric ID of the section to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Pin
>
> **Slug:** `PINTEREST_DELETE_PIN`
>
> Permanently delete a Pinterest Pin by ID. Production Pin writes require Pinterest Standard access.
>
> #### Input Parameters
>
> **pin\_id** `string` *required*
>
> Numeric ID of the Pin to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Analytics
>
> **Slug:** `PINTEREST_GET_ACCOUNT_ANALYTICS`
>
> Get aggregate Pinterest account analytics over a UTC date range, with optional metric, content, platform, source, and split filters.
>
> #### Input Parameters
>
> **source** `string ("ALL" | "YOUR_PINS" | "OTHER_PINS")`
>
> Include ALL activity, YOUR\_PINS, or OTHER\_PINS.
>
> **app\_type** `string ("ALL" | "MOBILE" | "TABLET" | "WEB")`
>
> App or device filter: ALL, MOBILE, TABLET, or WEB.
>
> **end\_date** `string` *required*
>
> UTC report end date in YYYY-MM-DD format. It must be on or after start\_date and no more than 90 days after it.
>
> **pin\_format** `string ("ALL" | "ORGANIC_IMAGE" | "ORGANIC_PRODUCT" | "ORGANIC_VIDEO" | "ADS_STANDARD" | "ADS_PRODUCT" | "ADS_VIDEO" | "ADS_IDEA")`
>
> Pin format to include, or ALL for every supported format.
>
> **start\_date** `string` *required*
>
> UTC report start date in YYYY-MM-DD format. Pinterest allows dates up to 90 days before today.
>
> **split\_field** `string ("NO_SPLIT" | "APP_TYPE" | "OWNED_CONTENT" | "SOURCE" | "PIN_FORMAT")`
>
> Group results by APP\_TYPE, OWNED\_CONTENT, SOURCE, or PIN\_FORMAT. NO\_SPLIT returns one aggregate bucket.
>
> **content\_type** `string ("ALL" | "PAID" | "ORGANIC")`
>
> Include ALL, PAID, or ORGANIC account activity.
>
> **metric\_types** `array`
>
> Metrics to return. Omit to request Pinterest's default metric set; multiple values are sent as one comma-separated query value.
>
> **claimed\_content** `string ("OTHER" | "CLAIMED" | "BOTH")`
>
> Filter Pins by claimed-domain relationship: OTHER, CLAIMED, or BOTH.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Board
>
> **Slug:** `PINTEREST_GET_BOARD`
>
> Get one Pinterest board by ID, including secret boards available to the connected account.
>
> #### Input Parameters
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Inspiration Trends
>
> **Slug:** `PINTEREST_GET_INSPIRATION_TRENDS`
>
> Get Pinterest editorial trend articles or featured trend topics for a supported region.
>
> #### Input Parameters
>
> **region** `string ("US" | "GB+IE" | "CA")` *required*
>
> Pinterest Trends market: US, GB+IE, or CA.
>
> **interest** `string ("ALL" | "ANIMALS" | "ARCHITECTURE" | "ART" | "BEAUTY" | "DIY_AND_CRAFTS" | "EDUCATION" | "EVENT_PLANNING" | "FASHION" | "FOOD_AND_DRINKS" | "GARDENING" | "HEALTH" | "HOME_DECOR" | "PARENTING" | "TRAVEL" | "WEDDING")`
>
> Interest category for featured\_topics. Leave as ALL when trend\_source is editorial\_articles.
>
> **trend\_source** `string ("editorial_articles" | "featured_topics")` *required*
>
> Inspiration feed to return: editorial\_articles for published trend articles or featured\_topics for topic groups by interest.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Keyword Trends
>
> **Slug:** `PINTEREST_GET_KEYWORD_TRENDS`
>
> Find Pinterest's top growing, monthly, yearly, or seasonal search keywords for a supported market, optionally filtered to an audience or search terms.
>
> #### Input Parameters
>
> **ages** `array`
>
> Optional audience age ranges used to restrict the trends.
>
> **limit** `integer`
>
> Maximum ranked keyword trends to return (1-50).
>
> **region** `string ("US" | "CA" | "DE" | "FR" | "ES" | "IT" | "DE+AT+CH" | "GB+IE" | "IT+ES+PT+GR+MT" | "PL+RO+HU+SK+CZ" | "SE+DK+FI+NO" | "NL+BE+LU" | "AR" | "BR" | "CO" | "MX" | "MX+AR+CO+CL" | "AU+NZ")` *required*
>
> Pinterest Trends market. Supported values include individual country codes such as US and grouped markets such as GB+IE.
>
> **genders** `array`
>
> Optional audience gender groups. Unknown includes unspecified or custom profile settings.
>
> **interests** `array`
>
> Optional Pinterest interest categories used to restrict the audience.
>
> **trend\_type** `string ("growing" | "monthly" | "yearly" | "seasonal")` *required*
>
> Ranking timeframe: growing uses quarterly growth, monthly uses last-month volume, yearly uses last-year volume, and seasonal uses recurring growth.
>
> **include\_keywords** `array`
>
> Optional search terms; returned trends must include at least one term. Each term must contain 1-100 characters, with at most 50 terms.
>
> **include\_demographics** `boolean`
>
> Include age and gender search-volume distributions for each keyword.
>
> **normalize\_against\_group** `boolean`
>
> When true, normalize all time series against the audience group's shared peak so relative search volume can be compared between keywords.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Media
>
> **Slug:** `PINTEREST_GET_MEDIA`
>
> Get a registered Pinterest video's current upload or processing status by media ID.
>
> #### Input Parameters
>
> **media\_id** `string` *required*
>
> Numeric Pinterest media registration ID returned by REGISTER\_MEDIA.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pin
>
> **Slug:** `PINTEREST_GET_PIN`
>
> Get one public or secret Pinterest Pin by ID.
>
> #### Input Parameters
>
> **pin\_id** `string` *required*
>
> Numeric Pinterest Pin ID.
>
> **include\_metrics** `boolean`
>
> Include available 90-day and lifetime Pin metrics.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Pin Analytics
>
> **Slug:** `PINTEREST_GET_PIN_ANALYTICS`
>
> Get daily, summary, and lifetime analytics for one Pinterest Pin over a date range. Recent daily values may remain in PROCESSING status.
>
> #### Input Parameters
>
> **pin\_id** `string` *required*
>
> Numeric Pinterest Pin ID.
>
> **app\_type** `string ("ALL" | "MOBILE" | "TABLET" | "WEB")`
>
> App or device data to include: ALL, MOBILE, TABLET, or WEB.
>
> **end\_date** `string` *required*
>
> UTC report end date in YYYY-MM-DD format, at most 90 days after start\_date.
>
> **start\_date** `string` *required*
>
> UTC report start date in YYYY-MM-DD format, at most 90 days before today.
>
> **metric\_types** `array` *required*
>
> Pin metrics to return. Values are sent to Pinterest as one comma-separated query parameter.
>
> **split\_by\_app\_type** `boolean`
>
> Split analytics into app-type buckets instead of one aggregate bucket.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product Trends
>
> **Slug:** `PINTEREST_GET_PRODUCT_TRENDS`
>
> Get currently growing shopping categories or detailed trend metrics for specified leaf product categories.
>
> #### Input Parameters
>
> **ages** `array`
>
> Optional trending-mode age buckets.
>
> **mode** `string ("trending" | "details")` *required*
>
> Use trending to discover growing shopping categories, or details to inspect specified leaf product categories. For details, reuse the product\_category name returned by trending, not its numeric ID.
>
> **region** `string ("US" | "GB+IE" | "CA")` *required*
>
> Market to analyze: US, GB+IE, or CA.
>
> **genders** `array`
>
> Optional trending-mode gender filters.
>
> **verticals** `array`
>
> Optional trending-mode vertical filters: FASHION, HOME\_DECOR, or BEAUTY.
>
> **lookback\_days** `integer ("90" | "180" | "365" | "730")`
>
> Details-mode historical window: 90, 180, 365, or 730 days.
>
> **engagement\_type** `string ("ENGAGEMENT" | "OUTBOUND_CLICK" | "SAVE")`
>
> Metric to analyze: ENGAGEMENT, OUTBOUND\_CLICK, or SAVE.
>
> **product\_categories** `array`
>
> Required when mode is details: 1-20 leaf product categories to inspect. Pass each trending result's product\_category string, such as BAGS\_AND\_LUGGAGE; pinterest\_product\_category\_id numeric values are not accepted. Omit in trending mode. Broad verticals such as BEAUTY are not valid product categories.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Profile
>
> **Slug:** `PINTEREST_GET_PROFILE`
>
> Get the connected Pinterest account's profile and content counts.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Top Pins
>
> **Slug:** `PINTEREST_GET_TOP_PINS`
>
> Return the connected account's top Pinterest Pins or top video Pins ranked by an analytics metric.
>
> #### Input Parameters
>
> **sort\_by** `string` *required*
>
> Metric used to rank Pins. For pin\_kind=all: ENGAGEMENT, SAVE, IMPRESSION, OUTBOUND\_CLICK, or PIN\_CLICK. For pin\_kind=video: SAVE, IMPRESSION, OUTBOUND\_CLICK, VIDEO\_MRC\_VIEW, VIDEO\_AVG\_WATCH\_TIME, VIDEO\_V50\_WATCH\_TIME, QUARTILE\_95\_PERCENT\_VIEW, VIDEO\_10S\_VIEW, or VIDEO\_START.
>
> **end\_date** `string` *required*
>
> UTC report end date in YYYY-MM-DD format. It must be on or after start\_date and no more than 90 days after it.
>
> **num\_pins** `integer`
>
> Number of ranked Pins to return (1-50).
>
> **pin\_kind** `string ("all" | "video")`
>
> Ranking route to use: all for top Pins or video for top video Pins. The selected route determines the valid sort and metric values.
>
> **start\_date** `string` *required*
>
> UTC report start date in YYYY-MM-DD format. It cannot be more than 90 days before today.
>
> **content\_type** `string ("ALL" | "PAID" | "ORGANIC")`
>
> Filter analytics to ALL, PAID, or ORGANIC content.
>
> **metric\_types** `array`
>
> Optional metrics to include for each Pin. pin\_kind=all accepts ENGAGEMENT, ENGAGEMENT\_RATE, IMPRESSION, OUTBOUND\_CLICK, OUTBOUND\_CLICK\_RATE, PIN\_CLICK, PIN\_CLICK\_RATE, SAVE, and SAVE\_RATE. pin\_kind=video accepts IMPRESSION, SAVE, OUTBOUND\_CLICK, VIDEO\_MRC\_VIEW, VIDEO\_AVG\_WATCH\_TIME, VIDEO\_V50\_WATCH\_TIME, QUARTILE\_95\_PERCENT\_VIEW, VIDEO\_10S\_VIEW, and VIDEO\_START. Values are sent as one comma-separated query value.
>
> **claimed\_content** `string ("OTHER" | "CLAIMED" | "BOTH")`
>
> Filter Pins by claimed-domain ownership: OTHER, CLAIMED, or BOTH.
>
> **created\_in\_last\_30\_days** `boolean`
>
> When true, restrict results to Pins created in the last 30 days.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Website Verification
>
> **Slug:** `PINTEREST_GET_WEBSITE_VERIFICATION`
>
> Get the connected account's website-claim verification methods and material. The response contains sensitive verification values.
>
> #### Input Parameters
>
> **include\_file\_content** `boolean`
>
> Include the potentially large HTML verification file content; false returns only method metadata and filename.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Boards
>
> **Slug:** `PINTEREST_LIST_BOARDS`
>
> List the connected account's public, protected, or secret Pinterest boards one page at a time.
>
> #### Input Parameters
>
> **privacy** `string ("ALL" | "PUBLIC" | "PROTECTED" | "SECRET" | "PUBLIC_AND_SECRET")`
>
> Board privacy filter: ALL, PUBLIC, PROTECTED, SECRET, or PUBLIC\_AND\_SECRET.
>
> **bookmark** `string`
>
> Opaque bookmark returned by the previous page. Omit for the first page.
>
> **page\_size** `integer`
>
> Maximum boards to return (1-250).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Board Sections
>
> **Slug:** `PINTEREST_LIST_BOARD_SECTIONS`
>
> List sections within a Pinterest board one page at a time.
>
> #### Input Parameters
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> **bookmark** `string`
>
> Opaque bookmark returned by the previous page. Omit for the first page.
>
> **page\_size** `integer`
>
> Maximum sections to return (1-250).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Pins
>
> **Slug:** `PINTEREST_LIST_PINS`
>
> List account Pins, Pins on a board, or Pins in a board section using one parameterized read tool. Account-level listing may omit secret-board Pins; provide board\_id for reliable secret-board inventory.
>
> #### Input Parameters
>
> **board\_id** `string`
>
> Board ID to list from; omit for the account-level Pin list.
>
> **bookmark** `string`
>
> Opaque bookmark returned by the previous page. Omit for the first page.
>
> **page\_size** `integer`
>
> Maximum Pins to return (1-250).
>
> **section\_id** `string`
>
> Section ID to list from; requires board\_id.
>
> **creative\_types** `array`
>
> Optional Pin creative-type filters for account or board listing. Pinterest does not support this filter for section listing.
>
> **include\_metrics** `boolean`
>
> Include available 90-day and lifetime Pin metrics for account or board listing. Pinterest does not support metrics for section listing.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Profile Resources
>
> **Slug:** `PINTEREST_LIST_PROFILE_RESOURCES`
>
> List the connected Pinterest profile's followers, followed users, followed boards, claimed websites, or linked businesses, or list followed interests for a specified username.
>
> #### Input Parameters
>
> **bookmark** `string`
>
> Opaque bookmark returned by the previous page. Ignored for linked\_businesses.
>
> **username** `string`
>
> Pinterest username required for followed\_interests. Use Get Profile to discover the connected account's username.
>
> **feed\_type** `string ("ALL" | "RANKED" | "CREATOR_ONLY" | "RANKED_CREATOR_ONLY")`
>
> For following\_users, select ALL, RANKED, CREATOR\_ONLY, or RANKED\_CREATOR\_ONLY followees.
>
> **page\_size** `integer`
>
> Maximum resources to return (1-250). Ignored for linked\_businesses, which is not paginated.
>
> **resource\_type** `string ("followers" | "following_users" | "following_boards" | "followed_interests" | "websites" | "linked_businesses")` *required*
>
> Profile resource to list: followers, following\_users, following\_boards, followed\_interests, websites, or linked\_businesses.
>
> **explicit\_following** `boolean`
>
> For following\_users or following\_boards, return only explicitly followed resources when true.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Register Media
>
> **Slug:** `PINTEREST_REGISTER_MEDIA`
>
> Register a Pinterest video upload and return the media ID, upload URL, and all multipart parameters required to upload the video before creating a video Pin. This action registers the upload but does not upload video bytes.
>
> #### Input Parameters
>
> **media\_type** `string`
>
> Pinterest currently supports only video media registration.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save Pin
>
> **Slug:** `PINTEREST_SAVE_PIN`
>
> Save an existing Pinterest Pin to a board or board section and return the new saved Pin.
>
> #### Input Parameters
>
> **pin\_id** `string` *required*
>
> Numeric ID of the existing Pinterest Pin to save.
>
> **board\_id** `string`
>
> Numeric ID of the destination board.
>
> **board\_section\_id** `string`
>
> Numeric ID of the destination board section.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Search Own Content
>
> **Slug:** `PINTEREST_SEARCH_OWN_CONTENT`
>
> Search the connected account's own boards or Pins, including secret content when authorized. This does not search Pinterest's global partner Pin index.
>
> #### Input Parameters
>
> **query** `string`
>
> Text to search in the connected account's content. Required when resource\_type is pins; omit when browsing boards without a search term.
>
> **bookmark** `string`
>
> Opaque bookmark returned by the previous page. Omit for the first page.
>
> **page\_size** `integer`
>
> Maximum board results to return (1-250). Pinterest exposes no page-size parameter for Pin search, so this value is ignored when resource\_type is pins.
>
> **resource\_type** `string ("boards" | "pins")` *required*
>
> Content type to search: boards or pins.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Board
>
> **Slug:** `PINTEREST_UPDATE_BOARD`
>
> Update a board's name, description, or privacy. Provide at least one update field. Secret-board writes require boards:write\_secret.
>
> #### Input Parameters
>
> **name** `string`
>
> Replacement board name (1-50 characters).
>
> **privacy** `string ("PUBLIC" | "SECRET")`
>
> Replacement privacy: PUBLIC or SECRET.
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> **description** `string`
>
> Replacement board description.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Board Section
>
> **Slug:** `PINTEREST_UPDATE_BOARD_SECTION`
>
> Rename a section within a Pinterest board.
>
> #### Input Parameters
>
> **name** `string` *required*
>
> Replacement section name (1-180 characters).
>
> **board\_id** `string` *required*
>
> Numeric Pinterest board ID.
>
> **section\_id** `string` *required*
>
> Numeric Pinterest section ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Pin
>
> **Slug:** `PINTEREST_UPDATE_PIN`
>
> Update content on a Pin owned by the connected account or move it to another board or section. Provide at least one update field. Production Pin writes require Pinterest Standard access. This Organic action does not support Business Access ad-account delegation.
>
> #### Input Parameters
>
> **link** `string`
>
> Replacement destination URL, up to 2048 characters. Pass null to clear it.
>
> **title** `string`
>
> Replacement Pin title, up to 100 characters. Pass null to clear it.
>
> **pin\_id** `string` *required*
>
> Numeric Pinterest Pin ID.
>
> **alt\_text** `string`
>
> Replacement accessible text, up to 500 characters. Pass null to clear it.
>
> **board\_id** `string`
>
> Numeric destination board ID when moving the Pin.
>
> **description** `string`
>
> Replacement Pin description, up to 800 characters. Pass null to clear it.
>
> **board\_section\_id** `string`
>
> Numeric destination section ID when moving the Pin. Pass null to remove the Pin from its current section.
>
> **ai\_disclosure\_values** `array`
>
> Replacement creator AI disclosures. Pass an empty list to clear the declarations; Pinterest receives this as ai\_disclosures.values.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
