---
title: User Created
slug: user-created
createdAt: 2025-09-12T20:36:01.371Z
---

This event is triggered when a customer creates a user account.

# Properties

| **Name**               | **Type**   | **Description**                               | **Required** |
| ---------------------- | ---------- | --------------------------------------------- | ------------ |
| `user_id`              | `string`   | Unique ID of the user                         | Yes          |
| `email`                | `string`   | Email of the user                             | Yes          |
| `roles`                | `string[]` | List of roles assigned to the user            | No           |
| `ship_address`         | `object`   | Shipping address of the user                  | No           |
| `bill_address`         | `object`   | Billing address of the user                   | No           |
| `store_credit_balance` | `number`   | Balance of store credit available to the user | No           |

## Ship address

| **Name**            | **Type** | **Description**                                          | **Required** |
| ------------------- | -------- | -------------------------------------------------------- | ------------ |
| `address1`          | `string` | The street address of the customer                       | No           |
| `address2`          | `string` | Additional street address of the customer (if necessary) | No           |
| `alternative_phone` | `string` | Customer's alternative phone number                      | No           |
| `phone`             | `string` | Customer's phone number                                  | No           |
| `city`              | `string` | City of the shipping address                             | No           |
| `company`           | `string` | Name of the company, if applicable                       | No           |
| `country`           | `string` | ISO country code for the shipping address                | No           |
| `name`              | `string` | Customer name                                            | No           |
| `state_name`        | `string` | ISO state code for the shipping address                  | No           |
| `zipcode`           | `string` | Zip or postal code for the shipping address              | No           |

## Bill address

| **Name**            | **Type** | **Description**                                          | **Required** |
| ------------------- | -------- | -------------------------------------------------------- | ------------ |
| `address1`          | `string` | The street address of the customer                       | No           |
| `address2`          | `string` | Additional street address of the customer (if necessary) | No           |
| `alternative_phone` | `string` | Customer's alternative phone number                      | No           |
| `phone`             | `string` | Customer's phone number                                  | No           |
| `city`              | `string` | City of the shipping address                             | No           |
| `company`           | `string` | Name of the company, if applicable                       | No           |
| `country`           | `string` | ISO country code for the shipping address                | No           |
| `name`              | `string` | Customer name                                            | No           |
| `state_name`        | `string` | ISO state code for the shipping address                  | No           |
| `zipcode`           | `string` | Zip or postal code for the shipping address              | No           |

# Sample Payload

```json
{
  "type": "track",
  "event": "User Created",
  "properties": {
    "user_id": "U1234",
    "email": "test@example.com",
    "roles": [],
    "store_credit_balance": 0.00,
    "ship_address": {
        "name": "John Doe",
        "address1": "123 Fake St",
        "address2": null,
        "city": "Oak Lawn",
        "zipcode": "60532",
        "phone": "1234567890",
        "state_name": "IL",
        "company": null
    },
    "bill_address": {
        "name": "John Doe",
        "address1": "123 Fake St",
        "address2": null,
        "city": "Oak Lawn",
        "zipcode": "60532",
        "phone": "1234567890",
        "state_name": "IL",
        "company": null
    }
  }
}
```

# Example

```bash
curl https://production.cdp.ingest.chord.co/api/track \
--header "Content-Type: application/json" \
--header "X-Write-Key: $CDP_WRITE_KEY" \
--data-raw '{
{
  "type": "track",
  "event": "User Created",
  "properties": {
    "user_id": "U1234",
    "email": "test@example.com",
    "roles": [],
    "store_credit_balance": 0.00,
    "ship_address": {
        "name": "John Doe",
        "address1": "123 Fake St",
        "address2": null,
        "city": "Oak Lawn",
        "zipcode": "60532",
        "phone": "1234567890",
        "state_name": "IL",
        "company": null
    },
    "bill_address": {
        "name": "John Doe",
        "address1": "123 Fake St",
        "address2": null,
        "city": "Oak Lawn",
        "zipcode": "60532",
        "phone": "1234567890",
        "state_name": "IL",
        "company": null
    }
  }
}
```