Release Notes
March 2026
We've removed the engagement_attribution_window configuration option from the Pinterest Ads connector setup form as it's no longer supported by Pinterest. For more details, see Pinterest changelogs.
February 2026
We renamed the PIN_ANALYTICS_REPORT table to PIN_APP_TYPE_REPORT. During the transition, we are populating both tables in parallel. The new PIN_APP_TYPE_REPORT table uses the app_type column instead of the device_type column.
January 2026
We have added two new reporting tables, MMM_CAMPAIGN_TARGETING_DAILY_REPORT and MMM_AD_GROUP_TARGETING_DAILY_REPORT. We are gradually rolling out this change to all existing connections.
December 2025
We now explicitly specify report status filters when requesting account analytics reports from Pinterest. This ensures we consistently retrieve data for all relevant report statuses, including active, paused, archived, and other status types.
This improvement enhances data completeness and reliability for your analytics tables. For more information, see our Pinterest Ads documentation.
November 2025
Row filtering is now supported for the following connectors:
- Amazon DynamoDB
- BigQuery
- Facebook Ads
- GitHub
- Google Analytics 4
- Google Sheets
- HVA Oracle
- HVA SQL Server
- LinkedIn Ad Analytics
- Microsoft Advertising
- MongoDB
- NetSuite SuiteAnalytics
- Pinterest Ads
- SFTP
- ServiceNow
- SharePoint
- Shopify
- Snapchat Ads
- Snowflake
- Stripe
- TikTok Ads
- Twitter Ads
- Workday RaaS
- Zendesk Support
To learn how to use row filtering and see the list of supported connectors, see our row filtering documentation.
October 2025
We unified each connector’s pre-built dbt Core–compatible data models into a single model. It standardizes and documents the Fivetran schemas created in your destination and outputs analytics-ready tables. Previously, most connectors used distinct source and transform models.
October 2024
We've added support for hourly report granulation for our Pinterest Ads connector. You can now choose whether to sync reports with daily or hourly granularity on the connection setup form. This change only applies to new Pinterest Ads connections created after October 11, 2024.
Previously, all reports were synced with daily granularity. For more information, see our Pinterest Ads setup guide.
June 2024
We have added the following new metrics to report tables:
checkout_roaspinterest_checkout_cost_per_actionpinterest_checkout_roastotal_checkout_conversion_ratetotal_add_to_cart_conversion_ratecustom_roastotal_custom_conversion_ratetotal_custom_value_in_micro_dollar
November 2023
We have added a new table, PIN_ANALYTICS_REPORT. The pin_stats column, previously removed in the July 2023 update from the PIN_HISTORY table, is now available in the new table. We will gradually roll out this change to all existing Pinterest Ads connections by December 20, 2023. For more information on the API used to obtain the data, see Pin analytics API documentation.
July 2023
We have upgraded our connector from Pinterest Ads API version 4 to version 5 because Pinterest has deprecated version 4. For more information, see Pinterest Ads' API documentation. As part of the upgrade, we have made the following schema changes:
We have added the following new tables:
AD_REJECTED_LABEL_HISTORYBOARD_PIN_THUMBNAIL_URLBOARD_SECTIONCATALOG_FEEDCONVERSION_TAG_CONFIGPIN_MEDIAPIN_MEDIA_IMAGE
We have added the following fields to the tables below:
account_permissionsandowner_usernameto theADVERTISER_HISTORYtablead_account_id,bid_strategy_type,conversion_learning_mode_type,feed_profile_id,pacing_delivery_type,placement_group, andsummary_statusto theAD_GROUP_HISTORYtableruleto theAUDIENCE_HISTORYtableboard_pins_modified_at,collaborator_count,description,follower_count,media_image_cover_url,owner_username,pin_count, andprivacyto theBOARD_HISTORYtabledefault_ad_group_budget_in_micro_currency,is_automated_campaign,is_campaign_budget_optimization, andis_flexible_daily_budgetsto theCAMPAIGN_HISTORYtabledescription,filters, andis_featuredto theCATALOG_PRODUCT_GROUPS_HISTORYtablealt_text,board_owner_username,board_section_id,dominant_color,is_standard,media_type, andparent_pin_idto thePIN_HISTORYtablead_account_idandcollection_items_destination_url_templateto thePIN_PROMOTION_HISTORYtablecatalog_product_group_name,is_mdl,slideshow_collections_title, andtracking_urlto thePRODUCT_GROUP_HISTORYtable
We have removed the following fields from the tables below because Pinterest has deprecated them:
billing_profile_status,billing_type,merchant_id, andstatusfrom theADVERTISER_HISTORYtablecampaign_budget_optimization_enabledfrom theCAMPAIGN_HISTORYtablefeatured_position,merchant_id, andproduct_countfrom theCATALOG_PRODUCT_GROUPS_HISTORYtableattribution,cacheable_id,comment_count,domain,image_large_url,image_medium_url,image_square_size_*,image_square_url,is_downstream_promotion,is_playable,is_promotable,is_repin,is_uploaded,is_video,not_promotable_reason,pin_stats,price_currency,price_value,promoter,repin_count,tracked_link, andtracking_paramsfrom thePIN_HISTORYtable
We have updated the primary keys for the
CUSTOMER_LIST_HISTORYtable. The new composite primary key consists of theidandupdated_timecolumns.
April 2022
We have expanded the Create a connection and Update a connection endpoints of our REST API. Now you can authorize the Pinterest Ads connection by adding the auth section to payloads.
February 2022
We have upgraded our connector from Pinterest Ads API version 3 to version 4, because Pinterest has deprecated version 3. For more information, see Pinterest Ads' API documentation.
We have made the following schema changes to support Pinterest Ads API version 4:
We have added two new tables, PRODUCT_ITEM_REPORT and CATALOG_PRODUCT_GROUPS_HISTORY.
We have added the following fields to the tables below:
catalog_product_group_idto thePRODUCT_GROUP_HISTORYtablebilling_profile_status,billing_type,merchant_id, andstatusto theADVERTISER_HISTORYtableupdated_timeandcreated_timeto theAUDIENCE_HISTORYtableenhanced_match_status,last_fired_time_ms,status, andversionto theCONVERSION_TAG_HISTORYtablesummary_status,status_time,end_time, andcampaign_budget_optimization_enabledto theCAMPAIGN_HISTORYtable
Pinterest has deprecated the following tables, so we have removed them:
APP_EVENT_TRACKING_CONFIG_HISTORYITEM_REPORTTAG_HISTORY
Pinterest has deprecated the following fields, so we have removed them from the tables below:
deleted,exclude, andnew_match_typefrom theKEYWORD_HISTORYtableThe
deletedfield was removed, but thearchivedfield has similar usage. According to Pinterest, archiving a keyword effectively deletes it. The keywords no longer receive metrics and are no longer visible within the parent entity's keywords list. For more information, see Pinterest's documentation.validandactivefrom thePRODUCT_GROUP_HISTORYtabletest_accountandis_one_tapfrom theADVERTISER_HISTORYtablerulefrom theAUDIENCE_HISTORYtablenum_matched_user_recordsandlist_typefrom theCUSTOMER_LIST_HISTORYtableverification_status,click_window_days,conversion_type,view_window_days,created_time,engagement_window_days, andupdated_timefrom theCONVERSION_TAG_HISTORYtablebilling_group,product_filter,measurement_partner_campaign_id, andplacement_exclusionfrom theCAMPAIGN_HISTORYtable
We have updated the primary keys for the following tables:
id,updated_time,advertiser_id, andaudience_typeis a new primary key for theAUDIENCE_HISTORYtabledate,product_group_id,advertiser_id,targeting_type, andtargeting_valueis a new primary key for thePRODUCT_GROUP_TARGETING_REPORTtable
October 2021
We now sync the pin_stats and influencer_pin_stats extra properties for the PIN_HISTORY table.
September 2021
We now sync the PRODUCT_GROUP_TARGETING report.
We now sync the following Targeting type tables:
TARGETING_AGE_BUCKETTARGETING_APP_TYPETARGETING_GENDERTARGETING_GEOTARGETING_GEO_METROTARGETING_GEO_REGIONTARGETING_INTERESTTARGETING_LOCALETARGETING_LOCATION
December 2020
The Pinterest Ads connector now supports the 0-day conversion attribution window. You can sync your data based on your custom Pinterest click, engagement, or view attribution windows, such as 1-day click/0-day engagement/0-day view, or 7-day click/0-day engagement/0-day view.
September 2020
We have released pre-built, dbt Core-compatible data models for Pinterest Ads. Find the models in Fivetran's dbt hub or data models documentation. Learn more about our dbt Core integration in our Transformations for dbt Core documentation.
July 2020
The Pinterest Ads connector now supports priority-first sync. Priority-first syncs fetch your most recent data first so that it's quickly ready for you to use. Pinterest Ads's priority-first syncs fetch the most recent thirty days' worth of data from the reporting tables.
To learn more, see our priority-first sync documentation.
May 2020
You can now configure your Pinterest Ads connector using the Fivetran REST API. This feature is in BETA and is available only for Standard and Enterprise accounts.
April 2020
We have added a new table, KEYWORD_REPORT.
February 2020
When setting up your connector, you can now select which advertisers you'd like to sync. Previously, Fivetran synced all advertisers by default.
January 2020
We have deprecated the optimization_goal field in the CAMPAIGN_HISTORY table. This change is required to migrate our Pinterest connector to the Pinterest Ads API V3. For more details, see Pinterest Ads' API documentation.
October 2019
We have upgraded the connector to Pinterest Ads API version 3, since versions 1 and 2 of the API have been deprecated. For more details, see Pinterest Ads' API documentation.
We have made a number of schema changes to support Pinterest Ads API version 3:
The new
objective_typefield has replaced theoptimization_goalfield in theCAMPAIGN_HISTORYtable. We will support theoptimization_goalfield for the next three months, and then it will be deprecated.The deprecated
bid_typefield has been reformatted and renamed tobillable_eventin theAD_GROUP_HISTORYtable.We have added the following fields to the tables below:
billable_eventto theAD_GROUP_HISTORYtablecreative_typeto thePIN_PROMOTION_HISTORYtable
Pinterest has deprecated the following fields, so we have removed them from the tables below:
bid_typefrom theAD_GROUP_HISTORYtablecampaign_type,bid_type,is_one_tap, andupgrade_statusfrom theCAMPAIGN_HISTORYtableupgrade_statusfrom thePIN_PROMOTION_HISTORYtable
July 2019
We released a new version of our Pinterest Ads connector, service version 1. You can now select how many months' worth of data you'd like to include in your initial sync. Choose from the following options:
- 3 months
- 6 months
- 12 months
- 24 months
- All time
October 2018
We no longer process ITEM reports for advertisers who are not running shopping campaigns, because Pinterest only allows advertisers who are running shopping campaigns to access these reports.
July 2018
The Pinterest Ads connector now syncs ITEM and PIN_PROMOTION_TARGETING reports.
The Pinterest Ads connector now syncs the following advertising reports:
- Advertiser
- Campaigns
- AdGroups
- Pin Promotions
- Product Groups
Read our Pinterest Ads connector documentation.
June 2018
The Pinterest Ads connector syncs Pinterest advertising meta-data related to Campaigns, AdGroups, Pin Promotions etc.
Read our Pinterest Ads connector documentation.