Staffbase application
Staffbase is an employee communication and experience platform. MIA connects to it to inventory the users of your organization and manage their access.
Authentication type and prerequisites
Authentication type — Staffbase API token sent through Basic authentication over HTTPS.
Prerequisites
- Have an administrator account with access to the Staffbase Studio.
- Use an Administrative token to inventory, create, and deactivate accounts.
- A Read-only token is sufficient for inventory only.
Create the API token
- In the Staffbase Studio, open Settings (gear icon), then System → API Access.
- Click Create API token.
- Enter a clear name, such as
MIA. - Select the Administrative access level.
- Click Create, then copy the token.
Store the token securely
The token grants access to users on your Staffbase platform. Never add it to a source-code repository or shared documentation. If it is exposed, revoke it in Staffbase and reconnect the application in MIA with a new token.
See Staffbase's official Creating and Retrieving an API Token guide.
Connect Staffbase to MIA
- Copy the base URL of your Staffbase platform. MIA accepts either format:
https://your-organization.staffbase.comhttps://your-organization.staffbase.com/api
- In MIA, open Applications → Add an application.
- Search for Staffbase.
- Enter:
- Domain: the Staffbase base URL;
- API token: the token copied from the Studio.
- Click Connect. MIA immediately verifies the token by importing the first page of users.
Offboarding behavior
Closing access from MIA deactivates the Staffbase account. This follows Staffbase's recommended offboarding procedure and avoids irreversible deletion. Deactivation does not delete the account data. If the same member is provisioned again, MIA automatically reactivates the account instead of creating a duplicate.
When the Staffbase API temporarily rate-limits a request (429), MIA automatically retries it twice before reporting the error.