list_campaigns
List Campaigns
List advertising campaigns for a given ad account. Supports filtering by campaign IDs and entity status. Can also list ad groups and ads within campaigns.
list_campaigns
List advertising campaigns for a given ad account. Supports filtering by campaign IDs and entity status. Can also list ad groups and ads within campaigns.
delete_pin
Permanently delete a Pin. This action cannot be undone.
manage_audience
Create or list custom audiences for ad targeting. Audiences can be based on customer lists, engagement, website visitors, or act-alike audiences.
search_pins
Search for pins by keyword. Returns matching pins from the authenticated user's content. Useful for finding specific pins across boards.
get_analytics
Retrieve analytics data for the user account, a specific pin, or an ad account. Provides metrics like impressions, saves, clicks, and engagement over a date range.
get_pin
Retrieve details of a specific Pin by its ID. Returns the pin's metadata including title, description, media, board info, and metrics.
list_catalogs
List product catalogs, catalog feeds, catalog items, or product groups. Provides access to shopping catalog data for managing product listings on Pinterest.
update_pin
Update an existing Pin's metadata. Can modify title, description, link, alt text, note, or move the pin to a different board or section.
manage_board_section
Create, update, delete, or list sections within a Pinterest board. Board sections help organize pins into subcategories within a board.
get_trends
Discover trending topics and product categories on Pinterest for a specific region. Useful for content strategy, understanding popular interests, and identifying trending products.
create_pin
Create a new Pin on Pinterest. Supports image pins (via URL), video pins, and carousel pins with multiple images. The pin will be saved to the specified board.
list_ad_accounts
List ad accounts accessible to the authenticated user. Includes account details like name, country, currency, and permissions. Can also retrieve a specific ad account by ID.
send_conversions
Send conversion events to Pinterest via the Conversions API. Supports web, in-app (Android/iOS), and offline events. Events are automatically deduplicated against the Pinterest Tag.
get_user_account
Retrieve the authenticated user's Pinterest account information, including username, profile image, account type, and follower/following counts.
list_boards
List boards owned by the authenticated user. Supports pagination and filtering by privacy type. Can also search boards by keyword.
manage_board
Create, update, or delete a Pinterest board. Use this to organize pins into themed collections. Supports public and secret board creation and modification.
list_pins
List pins owned by the authenticated user. Supports pagination and filtering by pin type. Can also list pins on a specific board or board section.
Create, manage, and analyze Pins and Boards on Pinterest. Manage advertising campaigns, ad groups, audiences, and targeting. Track conversions via server-to-server connection. Access organic and ad performance analytics. Manage product catalogs and shopping ads. Discover trending topics and categories. Read user account information and manage business accounts with member access and asset permissions.
Common questions about connecting Pinterest to AI agents with Metorial.