---
title: "Create Customer Record"
method: POST
path: "/data-in/customers"
tags: ["Data In"]
---

# Create Customer Record

`POST /data-in/customers`

Ingest customer data into Triple Whale. This endpoint allows users to upload detailed customer information — including contact details, address, consent status, and purchase history metadata.

## 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.
  - `customer_id` string, required — The unique identifier for the customer.
  - `platform` string — The platform associated with the customer record (e.g. `shopify`, `magento`, `woocommerce`, `klaviyo`).
  - `platform_account_id` string — The account ID associated with the platform.
  - `address1` string — The first line of the customer's default address.
  - `address2` string — The second line of the customer's default address.
  - `amount_spent` number — The total amount spent by the customer.
  - `city` string — The city of the customer's default address.
  - `country` string — The country of the customer's default address.
  - `country_code` string — The country code of the customer’s default address, according to ISO 3166-1 alpha-2.
  - `created_at` string, date-time — The time at which the customer 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.
  - `customer_tags` string[] — Tags associated with the customer, set in the main sales platform.
  - `display_name` string — The display name of the customer.
  - `email_address` string — The primary email address associated with the customer’s account.
  - `email_marketing_consent_collected_from` string — The source from which the customer's email marketing consent was collected.
  - `email_marketing_consent_opt_in_level` string — The level of consent provided by the customer for email marketing.
  - `email_marketing_consent_status` string — The current status of the customer's email marketing consent.
  - `email_marketing_consent_updated_at` string, date-time — The time at which the email marketing consent was updated. 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`).
  - `first_name` string — The customer's first name.
  - `last_name` string — The customer's last name.
  - `last_order_id` string — The ID of the most recent order from the customer.
  - `latitude` number — The latitude associated with the customer's location.
  - `locale` string — The locale setting associated with the customer's account.
  - `longitude` number — The longitude associated with the customer's location.
  - `note` string — Any note attached to the customer profile.
  - `orders` integer — The total number of orders placed by the customer.
  - `phone` string — The customer's phone number.
  - `product_subscriber_status` string — The customer's subscription status for products.
  - `sms_marketing_consent_collected_from` string — The source from which the customer's SMS marketing consent was collected.
  - `sms_marketing_consent_opt_in_level` string — The level of consent provided by the customer for SMS marketing.
  - `sms_marketing_consent_updated_at` string, date-time — The time at which the sms marketing consent was updated. 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`).
  - `state` string — The state or province of the customer's default address.
  - `state_code` string — The state or province code of the customer's default address.
  - `status` string — The current status of the customer in the system.
  - `tax_exempt` boolean — Indicates whether the customer is exempt from tax.
  - `zip` string — The zip or postal code of the customer's defaults address.

## Response `200`

Customer record successfully received.

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

## Other responses

- `400` — Bad Request
- `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)