---
title: "Create Post-Purchase Survey (PPS) Record"
method: POST
path: "/data-in/pps"
tags: ["Data In"]
---

# Create Post-Purchase Survey (PPS) Record

`POST /data-in/pps`

Ingest PPS data into Triple Whale. This endpoint allows users to upload  detailed post-purchase survey information, including order-related data, questions, and responses.

## Request body

- object
  - `shop` string, required — The exact Shop URL (e.g., 'example.myshopify.com'). Must match the Shop URL value shown in [Settings → Store](https://app.triplewhale.com/store-settings/general). The API key owner must also have access to the shop, otherwise the request will return 403.
  - `platform` string — The platform where the post-purchase survey originated.
  - `platform_account_id` string — The account ID associated with the platform.
  - `order_id` string, required — The unique identifier for the order associated with the PPS.
  - `created_at` string, date-time — The time at which the post-purchase survey record was created. Must be provided in ISO 8601 format, with explicit timezone information (`Z` or `+/-HH:mm` offset). Offsets are supported (e.g., `2024-11-29T12:00:00+02:00`). Defaults to the current time.
  - `total_price` number — The total price of the order associated with the PPS. Must be non-negative.
  - `question_id` string — Unique ID for the survey question. If omitted, the data will still be used for attribution (when `include_in_attribution = true`), but won’t appear in the PPS table, SQL, or Moby.
  - `question_text` string — The text of the survey question. Maps to `question` in the Post-Purchase Survey table.
  - `response_id` string — Unique ID for the survey response.
  - `response` string — The customer’s response to the survey question. Maps to `answer` in the Post-Purchase Survey table.
  - `include_in_attribution` boolean — Set to `true` to include this survey response in the [Total Impact and Triple Attribution models](https://kb.triplewhale.com/en/articles/5960333-understanding-and-utilizing-attribution-models#h_2edf480eb9). If omitted, Triple Whale will determine whether the question is attribution-related based on the `question_text`.
  - `source` string — The marketing or referral channel that appears in [Attribution](https://app.triplewhale.com/dashboards/attribution/all/). If omitted, Triple Whale infers the source from the `response` text. You may provide any string value, but using a [Standardized PPS Source ID](https://triplewhale.readme.io/docs/post-purchase-survey-pps-standardized-source-ids#/) (e.g. `facebook-ads`) ensures offline events are grouped with existing channels rather than appearing as a separate custom source.

## Response `200`

PPS record successfully received.

- object
  - `success` boolean
  - `message` string

## Other responses

- `400` — Bad Request
- `404` — Order Not Found
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/triplewhale/apis/triple-whale-api.md) · [All operations](https://skmtc.net/triplewhale/apis/triple-whale-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/triplewhale/triple-whale-api/revisions/96b22ac9b5a7/schema)