Skip to main content
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
HeaderTypeDescription
Authorizationstringprivate key

​
Request Body

ParameterTypeDescriptionRequired
user.user_idstringUnique user IDrequired
user.user_typestringType of userrequired
user.emailstringUser email addressrequired
user.namestringFull name of the userrequired
user.dobstringDate of birth (YYYY-MM-DD)optional
user.tierstringUser tier leveloptional
user.account_typestringAccount typeoptional
user.genderstringGenderoptional
user.mobilestringMobile phone numberoptional
user.registration_timestringRegistration timestamp (ISO)optional
device.typestringDevice typerequired
device.osstringOperating systemrequired
device.modelstringDevice modeloptional
device.languagestringDevice languageoptional
device.ip_addressstringIP addressrequired
device.device_idstringUnique device IDrequired
address.address1stringPrimary address linerequired
address.address2stringSecondary address lineoptional
address.citystringCityrequired
address.regionstringRegion / Stateoptional
address.zipcodestringPostal codeoptional
address.countrystringCountryrequired
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"
    }