Integrations
Give another tool access to your school's data with a token, choose exactly what it can do, and rotate or revoke it later.
An integration is another tool that reads or updates your Soljio data, such as an attendance sync or a script your developer wrote. You give it a token: a secret key that works only for your school and only for the access you choose. You can see when each token was last used, and revoke it at any time.
Who can do this: owners and admins. Some access is Owner only, so an admin can’t grant it.
Where to find it
Choose Settings, then Integrations in the General group. The section reads “Tokens let other tools read or update your data. Each one does only what you allow and can be revoked at any time.”
Create a token
Start
Choose Create token. A panel titled Create token opens.
Name it
Under Integration name, name the tool this token is for, such as “Attendance sync”. The name tells you what stops working if you revoke it.
Pick a lifetime
Expires after offers 30, 60, 90, or 180 days, or 1 year. It starts at 90 days. Shorter is safer.
Choose access
Under Access, tick only what the tool needs. Read access never allows a change. Access that reaches student, guardian, or access-control data carries a Sensitive label. Access marked Owner only is unavailable to admins; ask an owner to create that token.
Copy the secret
Choose Create token. The secret appears once, at the top of the section, with “Copy it now — it is never shown again.” Choose Copy token and give it to the person setting up the tool through a secure channel.
Check your tokens
Each row shows the integration name, the first characters of the secret, and a status:
| Status | Meaning |
|---|---|
| Active | The token works until it expires. |
| Superseded | You rotated it and gave the old secret extra time. It stops at the time shown. |
| Expired | Its lifetime ended. It no longer works. |
| Revoked | You revoked it. It no longer works. |
Under each row you see when it expires, when it was Last used (or Never), and who created it. Open Access to see what it can do.
Watch for two notes on a row:
- “This token expires soon. Rotate it to keep the integration running.”
- A note that the person who created it no longer has access to the school. The token keeps working until you revoke it, so decide whether the tool should keep running.
Rotate a token
Rotating gives the same tool a new secret with the same access. Do it before a token expires, or straight away if a secret leaks.
- Open the … menu on the row and choose Rotate….
- Pick Expires after for the new secret.
- Pick when the Old secret stops working: Now, In 1 hour, or In 24 hours. Choose Now if the secret leaked. Choose a window only when the tool needs time to switch to the new secret.
- Choose Rotate token, then copy the new secret.
Revoke a token
Open the … menu on the row and choose Revoke…, then confirm with Revoke token. The tool stops working immediately, and this can’t be undone. The row stays in the list so you can still see its history.
See what a tool did
Changes made by a tool appear in the Audit log with “API ·” and the token’s name, so you can tell which integration acted.
If something goes wrong
| Problem | What to do |
|---|---|
| A tool stopped working | Check its row. If it is Expired or Revoked, create a new token and update the tool to use it. |
| You can’t tick some access | It is Owner only. Ask an owner to create the token. |
| You lost the secret | It can’t be shown again. Rotate the token to get a new secret. |
| Creating a token fails at 25 tokens | A school can have 25 active tokens. Revoke one you no longer use. |
For developers
The person building the integration needs the Developers guides, starting with Authentication and Scopes.