Pinterest Ads
Sync audience segments to Pinterest Ads for customer list targeting. Upload your warehouse segments to reach Pinterest users.
Prerequisites
- A Pinterest Ads account
- Your Pinterest Ad Account ID
- Access to the Pinterest Marketing API
Authentication
Pinterest Ads uses OAuth 2.0.
- Click Connect with OAuth in Zeotap
- Sign in with your Pinterest account
- Authorize the requested permissions
OAuth scopes: ads:read, ads:write, user_accounts:read.
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Ad Account ID | Text | Yes | Your Pinterest ad account identifier. Example: 549755885175 |
Target Settings
| Field | Type | Required | Description |
|---|---|---|---|
| Audience Name | Text | Yes | Name of the customer list audience |
| Audience ID | Text | No | Existing audience ID to update. Leave blank to create new. |
Supported Operations
Sync Modes: Upsert, Mirror
Audience Sync Modes: Add, Remove, Mirror, Upsert
Features
- Field Mapping: No
- Schema Introspection: No
Match Keys
Pinterest matches customer list members on hashed emails (Zeotap uploads email-based customer lists; phone/MAID list types are not yet supported). Map raw columns and Zeotap normalizes and hashes them at delivery, or map pre-hashed digests directly:
| Field | Type | Description |
|---|---|---|
email | string | Raw email address — lowercased, trimmed, and SHA-256 hashed before upload |
hashed_email | string | Pre-hashed SHA-256 hex digest of the lowercase, trimmed email |
hashed_email_md5 | string | Pre-hashed MD5 hex digest of the lowercase, trimmed email. Pinterest also accepts SHA-256 — prefer hashed_email when you have both. |
When both a raw field and its pre-hashed counterpart are mapped, the pre-hashed value wins. Values with the wrong digest shape (SHA-256 not 64-hex, MD5 not 32-hex) are never uploaded — they are dropped (falling back to the raw column if mapped) and counted in the sync run logs. See Match Keys & Identifier Hashing for the full normalization contract, precedence, and validation rules.
Troubleshooting
Ad Account ID not found
Verify your Ad Account ID in Pinterest Ads Manager settings.
Audience not matching
Ensure email addresses are properly formatted and lowercase. Pinterest hashes identifiers before matching.