Pinterest Conversions API
Server-side event delivery to Pinterest's Conversions API for enhanced conversion tracking, bypassing browser limitations for improved data quality and privacy compliance.
Pinterest Conversions API is a server destination in the walkerOS flow:
Sends events server-side to Pinterest's Conversions API via raw HTTP (`POST https://api.pinterest.com/v5/ad_accounts/{adAccountId}/events`), hashing 12 user_data fields with SHA-256 before transmission. Supports deduplication with the web Pinterest Tag via `event_id` + `event_name`.
Installation
- Integrated
- Bundled
Configuration
This destination uses the standard destination config wrapper (consent, data, env, id, ...). For the shared fields see destination configuration. Package-specific fields live under config.settings and are listed below.
Settings
| Property | Type | Description | More |
|---|---|---|---|
accessToken | string | Pinterest conversion access token for Bearer authentication | |
adAccountId | string | Pinterest ad account ID from Ads Manager | |
action_source | Source of the event (web, app_android, app_ios, offline) | ||
doNotHash | Array<string> | Array of user_data fields that should not be hashed | |
test | boolean | Enable test mode by appending ?test=true to the API URL | |
url | string | Custom URL for Pinterest Conversions API endpoint | |
user_data | Record<string, string> | Mapping configuration for user data fields | |
partner_name | string | Third-party partner name for attribution |
Mapping
This package does not define custom rule-level settings. For the standard rule fields (consent, condition, data, batch, name, policy) see mapping.
Examples
Add to cart
A product add is sent to Pinterest as an add_to_cart conversion with the added item details.
Checkout
A completed order is sent to the Pinterest Conversions API as a checkout event with value, currency, and contents.
Page visit
A page view is sent to Pinterest as a page_visit conversion with the source URL.
Search
A site search event is forwarded to Pinterest as a search conversion with the query in custom data.
Signup
A user signup is sent to Pinterest as a signup conversion with the hashed email and external id.