Skip to content
Prefactor Docs

Create a new identity

POST
/api/v1/identity

Authorizations

Section titled “Authorizations ”

Request Body

Section titled “Request Body ”
Identity_DetailsForCreate
object
factors
Array
One of:
FactorData_Email_ForInput

Data for an email factor

object
name
FactorName

A valid factor name from the pool’s ruleset

string
email
type
string
Allowed values: email 
email
value
EmailAddress

Email address

string format: email 
test@example.com
metadata
object
key
additional properties
string
pool_id
Pool_Id

A valid pool ID

string
013xrzp12g3nqk8ng09nmc8kwqzfafa2

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

object
details
Identity_Details

Details of an identity

object
account_id
Account_Id

A valid account ID

string
013xrzp12g3nqk8n6cyr5x0k8yb10h59
claims
object
key
additional properties
string
domain_id
Domain_Id

A valid domain ID

string
013xrzp12g3nqk8n32sd3jyxq5a8ywe2
factors
Array
One of:
FactorData_Email

Data for an email factor

object
identifier
boolean
name
FactorName

A valid factor name from the pool’s ruleset

string
email
nid
FactorNid

A valid factor NID

string
013xrzp12g3nqk8ntbjcxw6f8m5m0e7x
persistent
boolean
type
string
Allowed values: email 
email
value
EmailAddress

Email address

string format: email 
test@example.com
vid
Vid

A valid VID

string
013xrzp12g3nqk8nntra99f99s9nk5cf
first_seen
One of:
InteractionDetails

A snapshot of the details of a particular device

object
at
Timestamp

Unix timestamp, seconds since midnight January 1, 1970 UTC

number
1234567890
remote_ip
One of:

IPv4 address in dotted-decimal notation

string format: ipv4 
127.0.0.1
user_agent
UserAgent

User-Agent string

string
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36
id
Identity_Id

A valid identity ID

string
013xrzp12g3nqk8n3f5qv5e2r757shwd
last_seen
One of:
InteractionDetails

A snapshot of the details of a particular device

object
at
Timestamp

Unix timestamp, seconds since midnight January 1, 1970 UTC

number
1234567890
remote_ip
One of:

IPv4 address in dotted-decimal notation

string format: ipv4 
127.0.0.1
user_agent
UserAgent

User-Agent string

string
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.114 Safari/537.36
metadata
object
key
additional properties
string
pool_id
Pool_Id

A valid pool ID

string
013xrzp12g3nqk8ng09nmc8kwqzfafa2
status
string
Allowed values: extant deleted 
extant
title

Identity title (based on identifier)

string
hello@example.com
type

Type of resource (always ‘identity’)

string
Allowed values: identity 
identity
status
string
Allowed values: success 
success

default

Section titled “default ”

Error

One of:
object
code
string
Allowed values: bad_request bad_authtoken not_authenticated not_permitted not_implemented unknown not_found unexpected_ref_type unexpected invalid_action invalid_value required_value 
bad_request
message
string
status
string
Allowed values: error 
error