Rest API
NameServices
- GETGet the name service for the environment and chain
- POSTCreate a new name service for the environment and chain
- DELdelete the name service for the environment and chain
- POSTGet the unsigned chain-specific message needed to be signed by the wallet owner using the wallet private key
- PUTEnable name service for this environment and chain
- PUTDisabled name service for this environment and chain
TestAccount
CustomHostnames
Exports
Gates
Settings
Organizations
Projects
Chainalysis
Environments
Sessions
Wallets
- POSTCreates a new embedded wallet for a user given an identifier
- POSTCreates a new embedded wallet. This API is meant to be called from a frame server.
- GETGet wallets by user
- POSTCreates a new wallet for the user. Note that if the user already has an embedded wallet linked, this call will fail.
- GETGet a wallet using the ID
- DELDelete wallet
Users
Members
MfaSettings
Invites
Origins
Tokens
Allowlists
- GETGet all allowlists for a environment
- POSTCreate new allowlist for a environment
- GETGet allowlist by id
- PUTUpdate the outcome, scope, or name of an allowlist entry by ID
- DELDelete an allowlist
- PUTEnable the allowlist
- PUTDisable the allow list
- GETGet all entries for an allowlist
- POSTCreate a new entry for an allowlist
- DELDelete an allowlist entry
SDK Views
Webhooks
- GETGet the Webhooks for an environment
- POSTCreates a new Webhooks for the project environment
- GETGet the Webhook for an environment
- PUTUpdate the Webhook for an environment
- DELDelete the Webhook for an environment
- GETGet the Messages for an webhook
- GETGet the Message deliveries for a webhook
- POSTRedeliver message for an webhook
SDK
- GETGet exchangerates
- GETCheck user field uniqueness
- POSTInitialize oauth auth sequence
- GETCheck that session is valid
- POSTScan a URL for potential malicious activity
- POSTSimulate a Solana transaction
- POSTSimulate an EVM transaction
- POSTSimulate an EVM AA UserOp
- POSTEndpoint to sign-in using a token issued by an external auth provider
- POSTAdd fees to a Solana transaction
- POSTEndpoint to verify using a token issued by an external auth provider
- GETGet auth token for given embedded wallet type
- GETReturn the passcode for the pregenerated embedded wallet of the authenticated user
- PUTUpdate wallet in a multi-wallet selection
- PUTClaim a pregenerated embedded wallet
- GETReturn the backup key for the embedded wallet of the authenticated user
- GETGet sdk healthcheck
- POSTEndpoint to refresh the JWT auth token using the current valid JWT auth token in the authorization header
- GETGet signin email provider
- GETGet redirect URL for Oauth provider login. This will return a string that the SDK can manipulate before redirecting the browser to.
- GETGet redirect URL for Oauth provider login
- GETOauth provider redirect endpoint
- POSTOauth provider redirect endpoint for apple ID
- GETOauth provider authorization endpoint
- POSTOauth provider verify endpoint
- POSTFarcaster provider SignIn endpoint
- POSTFarcaster provider Verify endpoint
- POSTOauth provider SignIn endpoint
- POSTReturns the authorization code or error retuned by oauth provider
- GETCreate nonce for authentication flow
- POSTPublish events for SDK
- GETGet the environment's settings
- POSTUpdate SDK settings for a specific environment
- POSTLink wallet to user
- POSTMerge users with conflict resolutions
- POSTVerify wallet transfer
- POSTRevoke a session
- POSTunlink wallet from user
- POSTprefetch information for wallet address
- POSTCreate a visit
- POSTVerify payload and return JWT
- GETFetch user profile for the current authenticated user
- PUTUpdate a user's fields
- PUTUpdate a user's Turnkey recovery email
- GETGets passkey data associated with a user
- PUTUpdate a passkey's info
- GETGet the current user's MFA Devices
- GETGet the current user's MFA by device id
- PUTUpdate a device
- DELDelete a device (if not default device)
- GETRegister a new TOTP MFA device and get Totp Secret
- POSTVerify TOTP MFA device
- POSTUpgrade JWT scope with valid MFA session
- GETRegister a new Passkey MFA device
- POSTVerify Passkey MFA device
- GETAuth Passkey MFA device
- POSTUpgrade JWT scope with valid MFA session
- POSTUpgrade JWT scope with valid MFA session
- GETGet recovery codes
- POSTGenerate new recovery codes for user
- POSTAfter successful verification allow to merge two owned accounts
- POSTCreate one or more new embedded wallets for a user
- DELDeletes the embedded wallets for a user
- GETGenerates the turnkey request body for a user's delete wallets request
- POSTAdd a wallet account to a user's existing Turnkey HD wallet
- GETGenerates the turnkey request body for a user's create wallet account request
- POSTInitialize the email authentication process for a user's embedded wallet
- PUTCompletes the passkey recovery process for a user's passkey embedded wallet
- POSTInitialize the passkey recovery process for a user's passkey embedded wallet
- POSTRegisters a session key for an embedded wallet
- GETRequests an export of an embedded wallet
- GETFind the configuration for the enabled networks associated to an environment
- GETConfiguration for enabled onramps
- POSTInitialize email verification process
- POSTInitialize sms verification process
- POSTSend new code for sms verification
- POSTVerify sms verification request
- POSTVerify an sms and sign in user
- POSTVerify email verification request
- POSTVerify an email and sign in user
- POSTSend new code for email verification
- GETFind jwks for public key
- GETGet the token balances for an account
- GETGet HTML with rendered Telegram login widget
- POSTHandle Telegram authentication
- POSTTelegram provider SignIn endpoint
- POSTTelegram provider check auth
- POSTTelegram provider Verify endpoint
Custom Fields
DeeplinkUrls
Creates many new users
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
ID of the environment
Update user data if user already exists
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
ID of the environment
36Query Parameters
Update user data if user already exists
Body
36255255255255255pending, complete 255255Standard ISO 3166-1 alpha-2 two-letter country code
255Alphanumeric with slugs and underscores username
255BTC wallet address
KDA wallet address
LTC wallet address
CKB wallet address
KAS wallet address
DOGE wallet address
When provided, the user email will be marked as verified in our system and the user will be allowed to sign in with that email. When social is enabled and the social provider has a verified email, we will automatically associate that social with the existing user.
If email is trusted and verified, please provide a emailVerifiedAt timestamp. This will ensure that a user signing in with this email can access the correctly-created user account.
255Valid blockchain wallet address, must be an alphanumeric string without any special characters
255ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE 255browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify 255255255Response
3636Valid blockchain wallet address, must be an alphanumeric string without any special characters
255363636This 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.
browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 blockchain, email, oauth, passkey, phoneNumber, externalUser emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify This field contains the phone number in the country. This could also contain the area code within a country.
This field contains the phone international country code. See https://countrycode.org/
ISO-3166 two-character country code. See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
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.
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.
An address associated with a wallet.
The public key associated with the address.
ordinals, payment, cosmos, evm 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.
This indicates if the user can sign in with this credential
3636255Standard ISO 3166-1 alpha-2 two-letter country code
255255255255255255255255255pending, complete Access lists evaluated by Dynamic when considering access for the user.
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
standard, custom Optional validation rules for the custom field
If this field must be unique for every user in the environment
The regex pattern that the text field must match
255The text that will be displayed for the checkbox field
255text, checkbox, select ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE 36ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE Valid blockchain wallet address, must be an alphanumeric string without any special characters
255browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 36OK, BLOCKED, FAILED Valid blockchain wallet address, must be an alphanumeric string without any special characters
25536emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify totp, passkey Whether or not the user has a verified this MFA Device
36The date and time the MFA device was created
The date and time the MFA device was verified
Whether or not this is the default MFA device for the user
The optional alias for the MFA device
3636Valid blockchain wallet address, must be an alphanumeric string without any special characters
255363636This 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.
browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 blockchain, email, oauth, passkey, phoneNumber, externalUser emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify This field contains the phone number in the country. This could also contain the area code within a country.
This field contains the phone international country code. See https://countrycode.org/
ISO-3166 two-character country code. See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
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.
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.
An address associated with a wallet.
The public key associated with the address.
ordinals, payment, cosmos, evm 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.
This indicates if the user can sign in with this credential
3636255Standard ISO 3166-1 alpha-2 two-letter country code
255255255255255255255255255pending, complete Access lists evaluated by Dynamic when considering access for the user.
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
standard, custom Optional validation rules for the custom field
If this field must be unique for every user in the environment
The regex pattern that the text field must match
255The text that will be displayed for the checkbox field
255text, checkbox, select ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE 36ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE Valid blockchain wallet address, must be an alphanumeric string without any special characters
255browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 36OK, BLOCKED, FAILED Valid blockchain wallet address, must be an alphanumeric string without any special characters
25536emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify totp, passkey Whether or not the user has a verified this MFA Device
36The date and time the MFA device was created
The date and time the MFA device was verified
Whether or not this is the default MFA device for the user
The optional alias for the MFA device
3636Valid blockchain wallet address, must be an alphanumeric string without any special characters
255363636This 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.
browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 blockchain, email, oauth, passkey, phoneNumber, externalUser emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify This field contains the phone number in the country. This could also contain the area code within a country.
This field contains the phone international country code. See https://countrycode.org/
ISO-3166 two-character country code. See https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes
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.
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.
An address associated with a wallet.
The public key associated with the address.
ordinals, payment, cosmos, evm 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.
This indicates if the user can sign in with this credential
3636255Standard ISO 3166-1 alpha-2 two-letter country code
255255255255255255255255255pending, complete Access lists evaluated by Dynamic when considering access for the user.
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
standard, custom Optional validation rules for the custom field
If this field must be unique for every user in the environment
The regex pattern that the text field must match
255The dropdown options for the select field
The text that will be displayed for the checkbox field
255text, checkbox, select ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE 36ETH, EVM, FLOW, SOL, ALGO, STARK, COSMOS, BTC, ECLIPSE Valid blockchain wallet address, must be an alphanumeric string without any special characters
255browserExtension, custodialService, walletConnect, qrCode, deepLink, embeddedWallet, smartContractWallet 363636Whether or not the wallet has an authenticator (passkey, api key, etc) attached to it.
36V1, V2 36OK, BLOCKED, FAILED Valid blockchain wallet address, must be an alphanumeric string without any special characters
25536emailOnly, magicLink, apple, bitbucket, coinbasesocial, discord, epicgames, facebook, farcaster, github, gitlab, google, instagram, linkedin, microsoft, twitch, twitter, blocto, banxa, dynamic, alchemy, zerodev, telegram, turnkey, coinbaseWaas, sms, spotify, tiktok, line, steam, shopify totp, passkey Whether or not the user has a verified this MFA Device
36The date and time the MFA device was created
The date and time the MFA device was verified
Whether or not this is the default MFA device for the user
The optional alias for the MFA device
email_already_exists, allowlist_already_exists, allowlist_entry_already_exists, reassign_wallet_error, reassign_wallet_confirm, members_cannot_delete_themself, username_already_exists, wrong_email_verification_token, wrong_sms_verification_token, invalid_email_verification, invalid_sms_verification, invalid_verification, invalid_position, too_many_sms_verification_attempts, too_many_email_verification_attempts, too_many_verification_attempts, organization_name_already_exists, project_name_already_exists, wallet_not_deployed, email_verification_required, phone_verification_required, invite_address_required, provider_not_available, forbidden_unlink_request, invalid_unlink_request, too_many_api_tokens, lock_timeout, lock_too_many_attempts, nft_token_gating_not_supported_for_chain, empty_chain_name, no_enabled_email_provider, no_enabled_sms_provider, invalid_key_export_url, invalid_dynamic_props, too_many_requests, too_many_organizations_for_user, too_many_projects_for_organization, email_associated_with_different_provider, user_has_already_account_with_email, user_has_already_account_with_phone_number, other_verify_failure, email_tied_to_embedded_wallet, invalid_invite, social_account_already_exists, invalid_email_address, invalid_gate, conflicting_embedded_wallet_providers, invalid_user, invalid_cors_origins, invalid_mobile_deeplink_urls, unauthorized_mobile_deeplink_url, invalid_private_key_format, invalid_embedded_wallet_settings, wallet_not_support_passkey, recovery_email_unavailable_or_invalid, connect_error, invalid_wallet_name, invalid_wallet_address, email_recovery_disabled, no_compatible_wallet_service_enabled, missing_aa_project_id, linked_embedded_wallet, invalid_mpc_environment, invalid_regex, repeated_options, missing_phone_number_or_email, duplicate_exists, mfa_device_not_found, mfa_invalid_code, mfa_invalid_request, invalid_phone, gate_exists, invalid_embedded_wallet_chains_configuration, merge_accounts_confirmation, merge_accounts_invalid, invalid_wallet_id, unable_to_fetch_balances, cannot_switch_to_unique, custom_field_data_not_unique, metadata_size_exceeded, invalid_custom_hostname, blocked_user_cannot_transfer_wallet, feature_not_enabled_in_suborg, invalid_username, invalid_external_auth, invalid_chain_address_match, invalid_update, cannot_delete_last_project, no_hd_wallet_found, wallet_account_exists_for_chain, too_many_embedded_wallets_for_user, too_many_embedded_wallets_per_chain_for_user, invalid_session_public_key, custom_field_not_unique Was this page helpful?