Send Recovery Codes via the User API

In this article, you will learn how to manage user access by sending recovery codes via the User API.

Staffbase offers many ways to manage user access. In some use cases, it is not possible to perform triggers to send recovery codes via CSV import or SCIM. In such cases, use the User API to simplify your business processes.

• You have already created an API token with administrative access via the Staffbase Studio. Learn more.

You need to first retrieve the user ID or the identifier of the user you want to trigger a recovery email for.

1. Make a GET request to the endpoint /users to list all users.

Copy To Clipboard
1    export AUTH="Basic {{Token}}"
2
3    curl -X GET 'https://exampleapp.staffbase.com/api/users' \
4    -H 'Authorization: $AUTH' \
5   --compressed | json_pp

2. Filter the response for the id or externalID of the user.

You have the user ID or the identifier of the user you want to trigger a recovery email for.

You can trigger recovery codes to allow one or more users to recover access to their accounts in case they forget their passwords. Learn more about different recovery methods.

On triggering the recovery code, the user receives an email with the recovery code. If the user has no registered email address, you have to communicate the recovery code directly to the user.

• Make a POST request to the endpoint /users/{userID}/recovery.

Copy To Clipboard
1  export USERID="5db0221d0a09a219c4ce9218"
2  export AUTH="Basic TOKEN"
3
4  curl "https://exampleapp.staffbase.com/api/users/{userID}/recovery" \
5    -X POST \
6    -H "Authorization: $AUTH" \
7    --compressed | json_pp
8    

You have triggered the recovery code for a single user. To bulk trigger the recovery code for multiple users, add a function to loop through multiple users to perform your requests.