---
title: Integrations
description: 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.

:::tip[Connecting an AI agent?]
AI agents such as a chat assistant connect differently. You approve them in your browser, and they appear under [Connected agents](/schools/administration/connected-agents).
:::

## 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

1. **Start**

    Choose **Create token**. A panel titled **Create token** opens.

2. **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.

3. **Pick a lifetime**

    **Expires after** offers 30, 60, 90, or 180 days, or 1 year. It starts at 90
    days. Shorter is safer.

4. **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.

5. **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.

:::warning[Treat a token like a password]
Anyone with the secret can do everything its access allows until it expires or you revoke it. Never paste it into an email or a shared document. Give each tool its own token.
:::

## 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.

1. Open the **…** menu on the row and choose **Rotate…**.
2. Pick **Expires after** for the new secret.
3. 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.
4. 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](/schools/administration/activity-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](/developers) guides, starting with [Authentication](/developers/authentication) and [Scopes](/developers/scopes).
