Identity API

CreateAddressRequest

object
typestringrequired

Type of address

Allowed values:MAILINGBUSINESSPHYSICAL

addressLine1stringrequired

First line of the street address.

Example:123 Main St

addressLine2string

Second line of the street address (suite, unit, etc.).

Example:Apt 4B

citystringrequired

City.

Example:Denver

statestringrequired

Two-letter US state code.

>= 2 characters<= 2 characters

Example:CO

zipstringrequired

ZIP code in 5-digit or ZIP+4 format.

Match pattern:^\d{5}(-\d{4})?$

Example:80202

countystring

County name.

Example:Denver

countrystringrequired

Country code (ISO alpha-2).

>= 2 characters<= 2 characters

Example:US

moveInDatestring(date)

Date the person moved to this address (YYYY-MM-DD).

Example:2020-01-15

preferredboolean

Whether this should be the person’s preferred address. When the person has no existing addresses, the server sets this to true regardless of the supplied value.

Default:false

Example

PhoneType

string

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example

PhoneV2

object

A phone record returned by V2 phone endpoints.

idstring(uuid)requiredread-only

Phone identifier.

Example:550e8400-e29b-41d4-a716-446655440000

typestringrequired

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example:CELL

numberstringrequired

10-digit phone number.

Example:3035551234

extensionstring

Optional phone extension.

Example:1234

preferredbooleanrequired

Whether this is the preferred phone number.

Example:true

createdAtstring(date-time)requiredread-only

RFC3339 UTC timestamp when the phone was created.

Example:2024-01-15T10:30:00Z

updatedAtstring(date-time)read-only

RFC3339 UTC timestamp when the phone was last updated.

Example:2024-01-15T14:45:00Z

Example

UpdatePhoneRequest

object
typestringrequired

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example:CELL

numberstringrequired

Phone number (exactly 10 digits)

Match pattern:^[0-9]{10}$

Example:3035551234

extensionstring

Optional phone extension (max 6 characters)

<= 6 characters

Example:1234

preferredbooleanrequired

Whether this is the preferred phone number

Example:true

Example

CreatePhoneRequest

object
typestringrequired

The type of phone

Allowed values:CELLBUSINESSRESIDENTFAX

Example:CELL

numberstringrequired

Phone number (exactly 10 digits)

Match pattern:^[0-9]{10}$

Example:3035551234

extensionstring

Optional phone extension (max 6 characters)

<= 6 characters

Example:1234

preferredbooleanrequired

Whether this is the preferred phone number

Example:true

Example