API Reference

Create Product Record

post
https://api.triplewhale.com/api/v2/data-in/products

Ingest product data into Triple Whale. This endpoint allows users to upload detailed product information, including variants, tags, collections, and images.

Body Params
string
required

The exact Shop URL (e.g., 'example.myshopify.com'). Must match the Shop URL value shown in Settings → Store. The API key owner must also have access to the shop, otherwise the request will return 403.

string
Defaults to custom-msp

The platform where the product originated.

string
Defaults to custom-msp

The account ID associated with the platform.

string
required

The unique identifier for the product. To use Product Analytics, matching line_items.product_id values must also be sent via the /orders endpoint.

string
required

The name or title of the product.

string

The vendor of the product.

string
Defaults to active

The status of the product in the connected sales platform (e.g., active, draft, archived).

product_tags
array of strings

Tags associated with the product, set in the main sales platform (e.g. Upsell, Order Credits, discount_eligible).

product_tags
string

The type or category of the product.

collections
array of strings

Collections the product belongs to.

collections
images
array of objects
Defaults to

Images associated with the product.

images
variants
array of objects
required

Variants of the product. If there are no variants, then use product_id.

variants*
date-time

The time at which the product 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.

date-time

The time at which the product record was last 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). Defaults to the current time.

Responses

Updated 3 months ago

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago