# customer.joined.free\_trial

## `customer.joined.free_trial`

#### Payload Structure

```js
{
  "payload": {
    "createdAt": "2025-05-30T13:51:00.551Z",
    "tierId": "c669d6e7",
    "merchantId": "inveterate",
    "detail": {
      "entryType": "SUBSCRIPTION_PURCHASE",
      "tierName": "TrialTier"
    },
    "updatedAt": "2025-05-30T13:51:00.551Z",
    "freeTrialStart": "2025-05-30T13:50:47.177Z",
    "freeTrialEnd": "2025-06-04T13:50:47.175Z",
    "customerId": "8921477710119"
  },
  "metadata": {
    "id": "2297571615b78a717726569a0bfed6fa",
    "retryCount": 0,
    "shopDomain": "inveterate.myshopify.com",
    "topic": "customer.joined.free_trial",
    "version": "2025-06",
    "triggerredAt": "2025-05-30T13:51:01.817Z"
  }
}
```

#### Payload Fields

**payload**

* `createdAt` (string): ISO timestamp when the event was created
* `tierId` (string): Unique identifier for the trial tier the customer joined
* `merchantId` (string): Merchant identifier
* `customerId` (string): Customer identifier
* `updatedAt` (string): ISO timestamp when the event was last updated
* `freeTrialStart` (string): ISO timestamp when the free trial started
* `freeTrialEnd` (string): ISO timestamp when the free trial ends
* `detail` (object): Additional details about the trial entry
  * `entryType` (string): How the customer joined (e.g., "SUBSCRIPTION\_PURCHASE")
  * `tierName` (string): Name of the trial tier

**metadata**

* `id` (string): Unique event identifier
* `retryCount` (number): Number of retry attempts for this event
* `shopDomain` (string): Shopify domain of the merchant
* `topic` (string): Event topic name
* `version` (string): API version
* `triggerredAt` (string): ISO timestamp when the event was triggered