← Tools Reference

Clerk

Clerk integration (Security, Developer Tools). Imported from open-connector.

API key11 toolshttps://api.clerk.com/v1
GET
clerk_list_users
List Clerk users with optional filtering and pagination.

/users

9 parameters
ParamTypeRequiredDescription
email_addressarrayoptionalA list of string values used by Clerk filters.
phone_numberarrayoptionalA list of string values used by Clerk filters.
usernamearrayoptionalA list of string values used by Clerk filters.
user_idarrayoptionalA list of string values used by Clerk filters.
external_idarrayoptionalA list of string values used by Clerk filters.
querystringoptionalA search query for Clerk users.
order_bystringoptionalThe Clerk order field, such as -created_at.
limitintegeroptionalMaximum number of users to return.
offsetintegeroptionalNumber of users to skip before returning results.
GET
clerk_count_users
Count Clerk users with optional filters.

/users/count

6 parameters
ParamTypeRequiredDescription
email_addressarrayoptionalA list of string values used by Clerk filters.
phone_numberarrayoptionalA list of string values used by Clerk filters.
usernamearrayoptionalA list of string values used by Clerk filters.
user_idarrayoptionalA list of string values used by Clerk filters.
external_idarrayoptionalA list of string values used by Clerk filters.
querystringoptionalA search query for Clerk users.
GET
clerk_get_user
Retrieve a Clerk user by ID.

/users/{user_id}

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
POST
clerk_create_user
Create a Clerk user.

/users

18 parameters
ParamTypeRequiredDescription
email_addressarrayoptionalEmail addresses to add to the new user.
phone_numberarrayoptionalPhone numbers to add to the new user.
web3_walletarrayoptionalWeb3 wallet addresses to add to the new user.
external_idstringoptionalAn external ID for the user.
first_namestringoptionalThe user's first name.
last_namestringoptionalThe user's last name.
usernamestringoptionalThe username attached to the Clerk user.
passwordstringoptionalThe user's password.
password_digeststringoptionalA password digest for the user.
password_hasherstringoptionalThe hashing algorithm used for password_digest.
skip_password_checksbooleanoptionalWhether Clerk should skip password validation checks.
skip_password_requirementbooleanoptionalWhether Clerk should allow creating the user without a password.
totp_secretstringoptionalThe TOTP secret to add to the user.
backup_codesarrayoptionalBackup codes to add to the user.
public_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
private_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
unsafe_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
created_atstringoptionalThe RFC3339 datetime to set as the user's creation time.
PATCH
clerk_update_user
Update a Clerk user.

/users/{user_id}

18 parameters
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
first_namestringoptionalThe user's first name.
last_namestringoptionalThe user's last name.
primary_email_address_idstringoptionalThe primary email address ID.
primary_phone_number_idstringoptionalThe primary phone number ID.
primary_web3_wallet_idstringoptionalThe primary Web3 wallet ID.
usernamestringoptionalThe username attached to the Clerk user.
passwordstringoptionalThe user's password.
password_digeststringoptionalA password digest for the user.
password_hasherstringoptionalThe hashing algorithm used for password_digest.
skip_password_checksbooleanoptionalWhether Clerk should skip password validation checks.
skip_password_requirementbooleanoptionalWhether Clerk should allow the user without a password.
sign_out_of_other_sessionsbooleanoptionalWhether Clerk should sign the user out of other sessions.
totp_secretstringoptionalThe TOTP secret to add to the user.
backup_codesarrayoptionalBackup codes to add to the user.
public_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
private_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
unsafe_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
PATCH
clerk_update_user_metadata
Deep merge metadata for a Clerk user.

/users/{user_id}/metadata

4 parameters
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
public_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
private_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
unsafe_metadataobjectoptionalArbitrary Clerk metadata stored on the user.
DELETE
clerk_delete_user
Delete a Clerk user.

/users/{user_id}

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
POST
clerk_ban_user
Ban a Clerk user.

/users/{user_id}/ban

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
POST
clerk_unban_user
Unban a Clerk user.

/users/{user_id}/unban

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
POST
clerk_lock_user
Lock a Clerk user.

/users/{user_id}/lock

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.
POST
clerk_unlock_user
Unlock a Clerk user.

/users/{user_id}/unlock

1 parameter
ParamTypeRequiredDescription
user_idstringrequiredThe Clerk user ID.