> For the complete documentation index, see [llms.txt](https://docs.senseloaf.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.senseloaf.ai/sia-chat/sia-for-notion.md).

# SIA for Notion

Screen candidates from your Notion board and write results back, without rebuilding your setup elsewhere

Some teams run hiring entirely out of Notion — a candidate database as the pipeline, plus wiki pages for levelling rubrics, comp bands, and interview guidance. Connecting Notion lets SIA plug directly into that setup instead of asking you to duplicate it somewhere else. It can screen whoever's already on the board, write results back into the same rows, and answer hiring questions straight from your own internal docs.

{% hint style="warning" %}
Notion grants access page by page, not all at once. During the connection step below, you'll choose exactly which pages SIA can see — anything you don't select stays invisible to SIA even after the connection succeeds. Decide ahead of time which candidate database and wiki pages you want SIA to use so you don't have to repeat this step later.
{% endhint %}

### Connecting Notion

<figure><img src="https://1117388020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGO7J9uIHFkn8y0ZeBqYC%2Fuploads%2FHmz92kVqEptWNVylAa8Z%2Fnotion-connect-flow.gif?alt=media&amp;token=71402d91-fab3-4ee1-9de5-888b331ed379" alt=""><figcaption><p>Connecting Notion</p></figcaption></figure>

1. In Chat, open **Connectors** from the sidebar
2. Find the **Notion** card and click **Connect Notion**
3. A Notion sign-in tab opens — sign in with your Notion account
4. On Notion's authorisation screen, click **Select pages**, then tick your candidate database and any wiki pages you want SIA to use
5. Confirm the selection — you're redirected back to Chat and the card now reads **Connected**

{% hint style="warning" %}
If you skip **Select pages** or leave your candidate database unticked, SIA connects successfully but sees nothing. If SIA says it can't find your database, the page was most likely never shared with it rather than the connection being broken. To fix this, open the page in Notion → click **•••** in the top right → **Connections** → add SIA. The same applies to any new hiring pages you create later — they won't appear to SIA automatically and need to be shared the same way.
{% endhint %}

### What you can do once connected

Once Notion is connected, SIA can work with the pages you shared:

* **Import your candidate database and screen everyone in it** — SIA reads the rows in your database and runs each candidate through screening
* **Write scores and stages back into the exact rows they came from** — matched row by row, so re-running a screen doesn't create duplicate entries
* **Answer questions from your hiring wiki** — levelling rubrics, comp bands, interview loop structure — instead of giving a generic answer
* **Add a candidate brief as a new page or drop a comment on a card** — so notes live inside Notion alongside everything else
* **Turn a role brief already in Notion into a hiring workflow** — no retyping the job description elsewhere

### Try it in chat

* *"Import our Notion candidate database and screen everyone for the Backend role."*
* *"Write the grades back into our Notion tracker."*
* *"What's our levelling rubric for L5?"*
* *"Move this candidate to Onsite on the hiring board."*

<figure><img src="https://1117388020-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGO7J9uIHFkn8y0ZeBqYC%2Fuploads%2F6R1PHeKpKSTY6HmhOZvb%2Fnotion-usecase-flow.gif?alt=media&amp;token=d3b8b30e-c30a-42cc-b893-4735dc4e7692" alt=""><figcaption><p>Try it with SIA Chat</p></figcaption></figure>

### A few things to note

* **Nothing is written to Notion without your approval.** Every change SIA makes — a grade, a stage move, a comment — is shown to you for review before it lands.
* **Resumes stored as files in Notion are read directly.** If a resume is a Google Drive link instead, Google Drive needs to be connected too — otherwise SIA can't follow the link.

### Disconnecting Notion

1. Go to **Connectors** in the sidebar
2. On the Notion card, click **Disconnect**

This removes SIA's access to every page it was granted. If you reconnect later, you'll need to go through **Select pages** again from scratch.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.senseloaf.ai/sia-chat/sia-for-notion.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
