Web3 Wallets

Used to interact with the web3 wallets of the logged in user.

Get All Web3 Wallets

Retrieve all web3 wallets associated with the current user.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

query Parameters

_clerk_session_id

string

The session_id associated with the requesting user.

Responses

200

Returns UserWeb3Wallets array.

401

Request was not successful

403

Request was not successful

404

Request was not successful

get/v1/me/web3_wallets

Response samples

application/json

[{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
}
]

Create Web3 Wallet

Create a new web3 wallet.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

query Parameters

_clerk_session_id

string

The session_id associated with the requesting user.

Request Body schema: application/x-www-form-urlencoded

web3_wallet

required

string

The web3 wallet to be added to the user.

Responses

200

Returns the response for Session wrapped Web3 wallet object.

401

Request was not successful

403

Request was not successful

404

Request was not successful

422

Request was not successful

post/v1/me/web3_wallets

Request samples

Payload

application/x-www-form-urlencoded

web3_wallet=string

Response samples

application/json

{"response": {"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

Get Web3 Wallet

Retrieve all properties associated a specific web3 wallet.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

web3_wallet_id

required

string

The web3 wallet ID.

Responses

200

Returns the response for Session wrapped Web3 wallet object.

401

Request was not successful

403

Request was not successful

404

Request was not successful

get/v1/me/web3_wallets/{web3_wallet_id}

Response samples

application/json

{"response": {"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

Delete Web3 Wallet

Delete a web3 wallet by id.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

web3_wallet_id

required

string

The web3 wallet ID.

Responses

200

Returns single DeletedPhoneNumber.

400

Request was not successful

401

Request was not successful

403

Request was not successful

404

Request was not successful

delete/v1/me/web3_wallets/{web3_wallet_id}

Response samples

application/json

{"response": {"id": "string",
"slug": "string",
"object": "string",
"deleted": true
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

Prepare Web3 Wallet Verification

Prepares verification for the provided web3 wallet.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

web3_wallet_id

required

string

The web3 wallet ID.

header Parameters

Origin

string

The origin of the request.

Request Body schema: application/x-www-form-urlencoded

strategy required	string^web3_\w+_signature$ The strategy used to verify the web3 wallet.
redirect_url	string or null The redirect URL to redirect the user to after verification.

Responses

200

Returns the response for Session wrapped Web3 wallet object.

401

Request was not successful

403

Request was not successful

404

Request was not successful

422

Request was not successful

post/v1/me/web3_wallets/{web3_wallet_id}/prepare_verification

Request samples

Payload

application/x-www-form-urlencoded

strategy=string&redirect_url=string

Response samples

application/json

{"response": {"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

Attempt Web3 Wallet Verification

Attempts to verify the provided web3 wallet.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

web3_wallet_id

required

string

The web3 wallet ID.

header Parameters

Origin

string

The origin of the request.

Request Body schema: application/x-www-form-urlencoded

signature

required

string

The signature that was generated from your Web3 Wallet to sign the message

Responses

200

Returns the response for Session wrapped Web3 wallet object.

400

Request was not successful

401

Request was not successful

403

Request was not successful

404

Request was not successful

422

Request was not successful

post/v1/me/web3_wallets/{web3_wallet_id}/attempt_verification

Request samples

Payload

application/x-www-form-urlencoded

signature=string

Response samples

application/json

{"response": {"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": "unverified",
"strategy": "web3_metamask_signature",
"attempts": 0,
"expire_at": 0,
"nonce": "string",
"message": "string"
},
"created_at": 0,
"updated_at": 0
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

➔ Next to Passkeys