---
title: "Send Measurement Source Of Truth (MSOT) attributed conversion events"
method: POST
path: "/ad_accounts/{ad_account_id}/msot/events"
tags: ["msot_events"]
---

# Send Measurement Source Of Truth (MSOT) attributed conversion events

`POST /ad_accounts/{ad_account_id}/msot/events`

**This feature is currently in beta and not available to all apps.**
If you are interested in joining the beta, reach out to your Pinterest account manager.

Advertisers or their measurement partners can send attributed MSOT conversion events to Pinterest
based on their `ad_account_id`. The request body should be a JSON object.

- These events will not be used in Reporting.

## Path parameters

- `ad_account_id` string, required

## Request body

- ConversionMSOTEventsCreate — Resource create operation model.
  - `action_timestamps` integer[] — Timestamp(s) when the ad action(s) happened. Unix timestamp in seconds.
  - `ad_group_id` string, required
  - `attribution_model` 'first_touch' | 'last_touch' | 'multi_touch' | 'mmm' — Attribution model used to attribute the conversion event.
  - `attribution_scope` 'view' | 'engagement' | 'click' — Ad event type used for attribution.
  - `attribution_score` number, double — Credit given to the attributed ad actions. Allowed values are > 0 and <= 1.
  - `campaign_id` string
  - `click_window` string — Click window used for attribution (for example, `1d`, `7d`, `30d`, `lifetime`).
  - `currency` 'UNK' | 'USD' | 'GBP' | 'CAD' | 'EUR' | 'AUD' | 'NZD' | 'SEK' | 'ILS' | 'CHF' | 'HKD' | 'JPY' | 'SGD' | 'KRW' | 'NOK' | 'DKK' | 'PLN' | 'RON' | 'HUF' | 'CZK' | 'BRL' | 'MXN' | 'ARS' | 'CLP' | 'COP' | 'INR' | 'TRY' — Currency Codes from ISO 4217
  - `event_id` string, required — A unique id string that identifies this event. If you are already sending us events through Conversions API, then this id should match the event_id sent through Conversions API.
  - `event_name` 'add_to_cart' | 'checkout' | 'lead' | 'signup', required — Type of user conversion event.
  - `event_timestamp` integer, required — The time when the event occurred. Unix timestamp in seconds.
  - `total_event_touchpoints` integer — Total number of ad events including other non-Pinterest ad platforms.
  - `total_events` integer — Deprecated: use `total_events_fractional` instead to avoid rounding errors. Total number of conversion events that are reported in one API call. If you are sending one API request for one attributed conversion event then this value should be 1. If you are sending multiple attributed conversion events in one API request then this value should be the total number of attributed conversion events in the request.
  - `total_events_fractional` number, double — Total number of conversion events that are reported in one API call. Use this field instead of `total_events` to send precise fractional values. If you are sending one API request for one attributed conversion event with full credit, this value should be 1.0. For partial attribution, send the exact fractional value (e.g., 0.5 for half credit).
  - `value` number, double — Order value of the conversion event. Required if `event_name` is `add_to_cart` or `checkout`.
  - `view_window` string — View window used for attribution (for example, `1d`, `7d`, `30d`).

## Response `200`

The request has succeeded.

## Other responses

- `201` — Resource create operation completed successfully.
- `400` — The request could not be understood by the server due to unexpected data.
- `401` — Authentication is required and has either failed or not been provided.
- `403` — The request was valid, but the server is refusing action. The user might not have the necessary permissions for a resource.
- `404` — The requested resource could not be found on this server.
- `429` — The user has sent too many requests in a given amount of time and is being rate limited.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.net/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/b698c180678a/schema)