Pinterest Ads Conversions

Send conversion events to Pinterest Ads

Configuration

Option	Description
`Ad account ID` Type: string Required: True	The ID of your Pinterest ad account. See https://help.pinterest.com/en/business/article/conversions-api
`Conversion token` Type: string Required: True	The conversion access token generated in Pinterest Ads Manager, under Conversions. See https://help.pinterest.com/en/business/article/conversions-api
`Action source` Type: choice Required: True	Where the conversion happened.
`Event ID` Type: string Required: True	A unique ID for the event. Pinterest uses it to deduplicate events sent by both the Pinterest tag and the Conversions API, so use the same ID in both.
`Event time` Type: string Required: True	A Unix timestamp in seconds of when the event happened.
`Event source URL` Type: string Required: False	The URL of the page where the event happened.
`User data` Type: dictionary Required: True	Customer information used for matching. Enter raw values: em, ph, fn, ln, ct, st, zp, country, external_id, hashed_maids, ge and db are lowercased, trimmed and SHA-256 hashed before sending. Empty values are left out. Pinterest needs em, hashed_maids, or both client_ip_address and client_user_agent. See https://developers.pinterest.com/docs/api/v5/events-create
`Test mode` Type: boolean Required: False	Send events as test events. Pinterest validates them and shows them under Test events in Ads Manager, but does not record them. Turn this off to send real traffic.

Using our REST API you can create this destination like so:

Terminal
# Create a new destination
curl --location 'https://us.i.posthog.com/api/environments/:project_id/hog_functions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <POSTHOG_PERSONAL_API_KEY>' \
--data '{
    "type": "destination",
    "name": "Pinterest Ads Conversions",
    "inputs": {
        "adAccountId": {
            "value": ""
        },
        "conversionToken": {
            "value": ""
        },
        "actionSource": {
            "value": ""
        },
        "eventId": {
            "value": ""
        },
        "eventTime": {
            "value": ""
        },
        "userData": {
            "value": ""
        }
    },
    "enabled": true,
    "template_id": "template-pinterest-ads"
}'