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

[POST]

{{baseURL}}/profile

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

Body

    {
      "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

Response

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

TECHNICAL REFERENCES

PAYLOAD SCHEMAS

RISK ENTITIES

Request

Header

Request Body

Successful Response

​Request

​Header

​Request Body

​

​Successful Response

Request

Header

Request Body

Successful Response