Skip to main content

Create a user by external reference

POST 
/api/users/by-reference

Requires admin token. Create a user in the Ownli System identified only by the partner's remote-system id (externalReference). Email, phone, address and policy are all optional. Identity is externalReference + contributor.

Request​

Query Parameters

    returnExistingUserIfExists boolean

    Return the user object if a user matching externalReference for this contributor exists. Default behavior is to return an error.

    Example: true

Body

required

    externalReference stringrequired

    Possible values: Value must match regular expression ^[A-Za-z0-9._:\-/]{1,128}$

    The user's id in the partner's remote/login system. This is the only required field. (Required)

    firstName string

    User's First Name. (Optional)

    lastName string

    User's Last Name. (Optional)

    email string

    User's Email. (Optional)

    isEmailVerified boolean

    Has the user's email been verified by the partner?

    phone string

    Cell Phone Number in the E.164 format +15556667777. (Optional)

    isPhoneVerified boolean

    Has the user's phone been verified by the partner?

    customField1 string

    Custom Field 1

    customField2 string

    Custom Field 2

    customField3 string

    Custom Field 3

    customField4 string

    Custom Field 4

    customField5 string

    Custom Field 5

    address

    object

    Address

    addressLine1 string

    Street Address

    addressLine2 string
    city string

    City

    state stringrequired

    2 Letter State Code (eg. AL, CA, CO etc.

    country string

    2 Letter Country Code. Must be US.

    zip string

    Zipcode

    policyInfo

    object

    Address

    policyNumber stringrequired

    Policy Number

    startDate string

    [startDate] The start date of the policy. ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ (e.g. 2024-01-01T00:00:00.000Z). Required unless caller is in policy.dates-optional.partner-ids.

    endDate string

    [endDate] The end date of the policy. ISO8601 UTC format YYY-MM-DDThh:mm:ss.SSSZ (e.g. 2024-01-01T00:00:00.000Z). Required unless caller is in policy.dates-optional.partner-ids.

Responses​

The created user object.

Schema

    id string

    Unique Id for the user

    firstName string

    User's first name

    lastName string

    User's last name

    email string

    User's email address

    phone string

    User's cell phone number

    adminNote string

    Internal admin note

    externalReference string

    The user's id in the partner's remote/login system, if the user was created via the external-reference endpoint. Null otherwise.

    customField1 string

    Custom Field 1

    customField2 string

    Custom Field 2

    customField3 string

    Custom Field 3

    customField4 string

    Custom Field 4

    customField5 string

    Custom Field 5

    address

    object

    Address

    addressLine1 string

    Street Address Line 1

    addressLine2 string

    Street Address Line 2

    city string

    City

    state string

    2 Letter State Code

    country string

    2 Letter Country Code

    zip string

    Zip

    policyInfo

    object

    Policy

    policyNumber string

    Policy Number

    startDate string

    Start Date

    endDate string

    End Date

    tosAnswer string

    Possible values: [None, Accepted, Declined]

    User's answer to terms of service for sharing data with Partner. (Only valid for certain partners)

    partnerCode string

    A code generated for the user to share with Partner. (Only valid for certain partners)

    dateRegistered string

    Time at which user was registered on the system

    updated string

    Last updated timestamp

    emailVerified boolean
    phoneVerified boolean
    fraud boolean
Loading...