MergeConflicts

Contains information needed for the SDK to surface merge conflicts when attempting to merge information from one user to another

fromUser

object

required

fromUser.id

string

required

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.projectEnvironmentId

string

required

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.verifiedCredentials

object[]

required

fromUser.verifiedCredentials.id

string

required

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.verifiedCredentials.format

enum<string>

required

Available options:

blockchain,

email,

oauth,

passkey,

phoneNumber,

externalUser

This indicates if the user can sign in with this credential

fromUser.verifiedCredentials.address

string

Valid blockchain wallet address, must be an alphanumeric string without any special characters

Maximum length: 255

Example:

"0xbF394748301603f18d953C90F0b087CBEC0E1834"

fromUser.verifiedCredentials.chain

string

fromUser.verifiedCredentials.refId

string

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.verifiedCredentials.signerRefId

string

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.verifiedCredentials.email

string

fromUser.verifiedCredentials.name_service

object

fromUser.verifiedCredentials.public_identifier

string

This is used to publicly identify a verified credential in a human-friendly way. For example, this will be the email address if credential format=email.

fromUser.verifiedCredentials.wallet_name

string

fromUser.verifiedCredentials.wallet_provider

enum<string>

Available options:

browserExtension,

custodialService,

walletConnect,

qrCode,

deepLink,

embeddedWallet,

smartContractWallet

fromUser.verifiedCredentials.wallet_properties

object

fromUser.verifiedCredentials.oauth_provider

enum<string>

Available options:

emailOnly,

magicLink,

apple,

bitbucket,

coinbasesocial,

discord,

epicgames,

facebook,

farcaster,

github,

gitlab,

google,

instagram,

linkedin,

microsoft,

twitch,

twitter,

blocto,

banxa,

coinbaseOnramp,

dynamic,

alchemy,

zerodev,

telegram,

turnkey,

coinbaseWaas,

sms,

spotify,

tiktok,

line,

steam,

shopify

fromUser.verifiedCredentials.oauth_username

string

fromUser.verifiedCredentials.oauth_display_name

string | null

fromUser.verifiedCredentials.oauth_account_id

string | null

fromUser.verifiedCredentials.phoneNumber

string

This field contains the phone number in the country. This could also contain the area code within a country.

Example:

"9171113333"

fromUser.verifiedCredentials.phoneCountryCode

string

This field contains the phone international country code. See https://countrycode.org/

Example:

"1"

fromUser.verifiedCredentials.isoCountryCode

string

ISO-3166 two-character country code. See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes

Example:

"US"

fromUser.verifiedCredentials.oauth_account_photos

string[]

fromUser.verifiedCredentials.oauth_emails

string[]

fromUser.verifiedCredentials.oauth_metadata

object

This object contains JSON metadata for a social-based verified credential. It may contain data about the user that does not fit into the other structured fields, and could include arbitrary fields about the user from the oauth provider's API.

fromUser.verifiedCredentials.previous_users

string[]

This will only be provided in the responses for GET /users/{userId}.Previous user IDs that owned this verified credential and was tranfered to the current user ID.

fromUser.verifiedCredentials.embedded_wallet_id

string | null

fromUser.verifiedCredentials.wallet_additional_addresses

object[]

An additional address associated with a wallet.

fromUser.verifiedCredentials.lastSelectedAt

string

This timestamp indicates the last time this verified wallet was either connected to the user account or selected to become the primary wallet on the account.

fromUser.lastVerifiedCredentialId

string

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.sessionId

string

Required string length: 36

Example:

"95b11417-f18f-457f-8804-68e361f9164f"

fromUser.alias

string | null

Maximum length: 255

Example:

"An example name"

fromUser.country

string | null

Standard ISO 3166-1 alpha-2 two-letter country code

Maximum length: 255

Example:

"US"

fromUser.email

string | null

Maximum length: 255

fromUser.firstName

string | null

Maximum length: 255

Example:

"An example name"

fromUser.jobTitle

string | null

Maximum length: 255

Example:

"An example name"

fromUser.lastName

string | null

Maximum length: 255

Example:

"An example name"

fromUser.phoneNumber

string | null

Maximum length: 255

fromUser.tShirtSize

string | null

Maximum length: 255

Example:

"An example name"

fromUser.team

string | null

Maximum length: 255

Example:

"An example name"

fromUser.username

string | null

Maximum length: 255

Example:

"An example name"

fromUser.firstVisit

string

fromUser.lastVisit

string

fromUser.newUser

boolean

fromUser.metadata

object

fromUser.mfaBackupCodeAcknowledgement

enum<string> | null

Available options:

pending,

complete

fromUser.btcWallet

string | null

fromUser.kdaWallet

string | null

fromUser.ltcWallet

string | null

fromUser.ckbWallet

string | null

fromUser.kasWallet

string | null

fromUser.dogeWallet

string | null

fromUser.emailNotification

boolean | null

fromUser.discordNotification

boolean | null

fromUser.lists

string[]

Access lists evaluated by Dynamic when considering access for the user.

fromUser.scope

string

A whitespace-separate list of permissions associated with the JWT token issued. This conforms to the JWT standard for scope claims: https://datatracker.ietf.org/doc/html/rfc8693#section-4.2

Example:

"superuser marketing operations"

fromUser.missingFields

object[]

fromUser.missingFields.name

string

required

fromUser.missingFields.required

boolean

required

fromUser.missingFields.enabled

boolean

required

fromUser.missingFields.unique

boolean

required

fromUser.missingFields.verify

boolean

required

fromUser.missingFields.type

enum<string>

Available options:

standard,

custom

fromUser.missingFields.validationRules

object

Optional validation rules for the custom field

fromUser.missingFields.validationRules.unique

boolean

If this field must be unique for every user in the environment

fromUser.missingFields.validationRules.regex

string

The regex pattern that the text field must match

Maximum length: 255

Example:

"^0x"

fromUser.missingFields.validationRules.validOptions

object[]

The dropdown options for the select field

Example:

[
  { "label": "small" },
  { "label": "medium" },
  { "label": "large" }
]

fromUser.missingFields.validationRules.checkboxText

string

The text that will be displayed for the checkbox field

Maximum length: 255

Example:

"Agree to the terms and conditions"

fromUser.missingFields.validationType

enum<string>

Available options:

text,

checkbox,

select

fromUser.missingFields.label

string

fromUser.missingFields.position

number

conflicts

object[]

required

Contains a merge conflict between two users with different values for the same user field data

conflicts.field

object

required

conflicts.field.name

string

required

conflicts.field.required

boolean

required

conflicts.field.enabled

boolean

required

conflicts.field.unique

boolean

required

conflicts.field.verify

boolean

required

conflicts.field.type

enum<string>

Available options:

standard,

custom

conflicts.field.validationRules

object

Optional validation rules for the custom field

conflicts.field.validationRules.unique

boolean

If this field must be unique for every user in the environment

conflicts.field.validationRules.regex

string

The regex pattern that the text field must match

Maximum length: 255

Example:

"^0x"

conflicts.field.validationRules.validOptions

object[]

The dropdown options for the select field

Example:

[
  { "label": "small" },
  { "label": "medium" },
  { "label": "large" }
]

conflicts.field.validationRules.checkboxText

string

The text that will be displayed for the checkbox field

Maximum length: 255

Example:

"Agree to the terms and conditions"

conflicts.field.validationType

enum<string>

Available options:

text,

checkbox,

select

conflicts.field.label

string

conflicts.field.position

number

conflicts.fromUser

object

required

Contains the current field value for the user.

conflicts.currentUser

object

required

Contains the current field value for the user.

Was this page helpful?

{
  "fromUser": {
    "id": "95b11417-f18f-457f-8804-68e361f9164f",
    "projectEnvironmentId": "95b11417-f18f-457f-8804-68e361f9164f",
    "verifiedCredentials": [
      {
        "address": "0xbF394748301603f18d953C90F0b087CBEC0E1834",
        "chain": "<string>",
        "refId": "95b11417-f18f-457f-8804-68e361f9164f",
        "signerRefId": "95b11417-f18f-457f-8804-68e361f9164f",
        "email": "jsmith@example.com",
        "id": "95b11417-f18f-457f-8804-68e361f9164f",
        "name_service": {
          "avatar": "<string>",
          "name": "<string>"
        },
        "public_identifier": "<string>",
        "wallet_name": "<string>",
        "wallet_provider": "browserExtension",
        "wallet_properties": {
          "turnkeySubOrganizationId": "95b11417-f18f-457f-8804-68e361f9164f",
          "turnkeyPrivateKeyId": "95b11417-f18f-457f-8804-68e361f9164f",
          "turnkeyHDWalletId": "95b11417-f18f-457f-8804-68e361f9164f",
          "isAuthenticatorAttached": true,
          "turnkeyUserId": "95b11417-f18f-457f-8804-68e361f9164f",
          "isSessionKeyCompatible": true,
          "version": "V1",
          "ecdsaProviderType": "zerodev_signer_to_ecdsa",
          "entryPointVersion": "v6",
          "kernelVersion": "v2_4"
        },
        "format": "blockchain",
        "oauth_provider": "emailOnly",
        "oauth_username": "<string>",
        "oauth_display_name": "<string>",
        "oauth_account_id": "<string>",
        "phoneNumber": "9171113333",
        "phoneCountryCode": "1",
        "isoCountryCode": "US",
        "oauth_account_photos": [
          "<string>"
        ],
        "oauth_emails": [
          "<string>"
        ],
        "oauth_metadata": {},
        "previous_users": [
          "95b11417-f18f-457f-8804-68e361f9164f"
        ],
        "embedded_wallet_id": "<string>",
        "wallet_additional_addresses": [
          {
            "address": "<string>",
            "publicKey": "<string>",
            "type": "ordinals"
          }
        ],
        "lastSelectedAt": "2023-11-07T05:31:56Z",
        "signInEnabled": true
      }
    ],
    "lastVerifiedCredentialId": "95b11417-f18f-457f-8804-68e361f9164f",
    "sessionId": "95b11417-f18f-457f-8804-68e361f9164f",
    "alias": "An example name",
    "country": "US",
    "email": "jsmith@example.com",
    "firstName": "An example name",
    "jobTitle": "An example name",
    "lastName": "An example name",
    "phoneNumber": "<string>",
    "policiesConsent": true,
    "tShirtSize": "An example name",
    "team": "An example name",
    "username": "An example name",
    "firstVisit": "2023-11-07T05:31:56Z",
    "lastVisit": "2023-11-07T05:31:56Z",
    "newUser": true,
    "metadata": {},
    "mfaBackupCodeAcknowledgement": "pending",
    "btcWallet": "<string>",
    "kdaWallet": "<string>",
    "ltcWallet": "<string>",
    "ckbWallet": "<string>",
    "kasWallet": "<string>",
    "dogeWallet": "<string>",
    "emailNotification": true,
    "discordNotification": true,
    "newsletterNotification": true,
    "lists": [
      "<string>"
    ],
    "scope": "superuser marketing operations",
    "missingFields": [
      {
        "name": "<string>",
        "required": true,
        "enabled": true,
        "unique": true,
        "verify": true,
        "type": "standard",
        "validationRules": {
          "unique": true,
          "regex": "^0x",
          "validOptions": [
            {
              "label": "small"
            },
            {
              "label": "medium"
            },
            {
              "label": "large"
            }
          ],
          "checkboxText": "Agree to the terms and conditions"
        },
        "validationType": "text",
        "label": "<string>",
        "position": 123
      }
    ]
  },
  "conflicts": [
    {
      "field": {
        "name": "<string>",
        "required": true,
        "enabled": true,
        "unique": true,
        "verify": true,
        "type": "standard",
        "validationRules": {
          "unique": true,
          "regex": "^0x",
          "validOptions": [
            {
              "label": "small"
            },
            {
              "label": "medium"
            },
            {
              "label": "large"
            }
          ],
          "checkboxText": "Agree to the terms and conditions"
        },
        "validationType": "text",
        "label": "<string>",
        "position": 123
      },
      "fromUser": {
        "userId": "95b11417-f18f-457f-8804-68e361f9164f",
        "value": "An example name"
      },
      "currentUser": {
        "userId": "95b11417-f18f-457f-8804-68e361f9164f",
        "value": "An example name"
      }
    }
  ]
}

Rest API

GlobalWallets

NameServices

TestAccount

CustomHostnames

Exports

Gates

Settings

Analytics

Organizations

Projects

Custom Networks

Chainalysis

Environments

Sessions

Wallets

Users

Visits

Members

MfaSettings

Invites

ExternalJwt

Origins

UserApiTokens

Tokens

Allowlists

Chains

SDK Views

Events

Webhooks

SDK

Custom Fields

DeeplinkUrls

Mfa