> ## Documentation Index
> Fetch the complete documentation index at: https://docs.profiledrisk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Profile

The Create Profile endpoint is used to explicitly register a profile in ProfiledRisk before or alongside event ingestion. This allows you to preload user, device, and address context so that later events are evaluated with a richer history.

> Profiles can also be created implicitly via event ingestion.\
> Use this endpoint when you want **direct control** over initial profile data.

### Request

```http [POST] theme={null}
{{baseURL}}/profile
```

### Header

| Header        | Type   | Description |
| ------------- | ------ | ----------- |
| Authorization | string | private key |

### Request Body

| Parameter               | Type   | Description                  | Required |
| ----------------------- | ------ | ---------------------------- | -------- |
| user.user\_id           | string | Unique user ID               | required |
| user.user\_type         | string | Type of user                 | required |
| user.email              | string | User email address           | required |
| user.name               | string | Full name of the user        | required |
| user.dob                | string | Date of birth (YYYY-MM-DD)   | optional |
| user.tier               | string | User tier level              | optional |
| user.account\_type      | string | Account type                 | optional |
| user.gender             | string | Gender                       | optional |
| user.mobile             | string | Mobile phone number          | optional |
| user.registration\_time | string | Registration timestamp (ISO) | optional |
| device.type             | string | Device type                  | required |
| device.os               | string | Operating system             | required |
| device.model            | string | Device model                 | optional |
| device.language         | string | Device language              | optional |
| device.ip\_address      | string | IP address                   | required |
| device.device\_id       | string | Unique device ID             | required |
| address.address1        | string | Primary address line         | required |
| address.address2        | string | Secondary address line       | optional |
| address.city            | string | City                         | required |
| address.region          | string | Region / State               | optional |
| address.zipcode         | string | Postal code                  | optional |
| address.country         | string | Country                      | required |

```json Body theme={null}
    {
      "user": {
        "user_id": "9931fac0-6bfa-4b3c-842c-7840006d89b6",
        "user_type": "individual",
        "email": "jane.doe@anon.com",
        "name": "Jane Doe",
        "dob": "1980-01-01",
        "tier": "silver",
        "account_type": "checking",
        "gender": "male",
        "mobile": "5797454931",
        "registration_time": "2022-12-12T12:15:05.392Z"
      },
      "device": {
        "type": "mobile",
        "os": "Android",
        "model": "Pixel 7",
        "language": "en-US",
        "ip_address": "154.72.170.233",
        "device_id": "ff97adb7-8d3d-4f15-94df-87e21e1212de"
      },
      "address": {
        "address1": "6238 Walker Unions Suite 802",
        "address2": "",
        "city": "North Sarah",
        "region": "",
        "zipcode": "23401",
        "country": "Morocco"
      }
    }
```

###

## Successful Response

```json Response theme={null}
    {
      "profile_id": "prf_01JABC9YEXAMPLE123",
      "user_id": "9931fac0-6bfa-4b3c-842c-7840006d89b6",
      "created_at": "2025-01-01T10:00:00Z",
      "status": "active"
    }
```