> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arya.so/llms.txt
> Use this file to discover all available pages before exploring further.

# Notion

> Use Notion databases as knowledge base or alternative repository.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/notion/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=fa93b2a73238c6d72ee6a48da2cc6f77" alt="Notion integration tile in Arya settings" width="1200" height="720" data-path="images/integrazioni/notion/shared/tile.svg" />
</Frame>

## What it does

Notion as documentation space linked to Arya. Sync Arya record lists as Notion databases, useful for teams using Notion as knowledge hub.

## Prerequisites

<Note>
  * Active account with Notion
  * **Admin** or **Manager** role on Arya to connect
  * OAuth authorisation (or API key, where applicable)
</Note>

## Connect Notion

<Steps>
  <Step title="Go to Settings → Integrations">Find **Notion** in the gallery and click **Connect**.</Step>
  <Step title="Authorise via OAuth">Opens Notion login page. Grant requested permissions.</Step>
  <Step title="Confirm in Arya">Arya tests the connection. If OK, you see "Connected" in green.</Step>
  <Step title="Configure preferences (optional)">Sync frequency, filters, field mapping. From **Settings → Integrations → \[Notion] → Configure**.</Step>
</Steps>

## What syncs

| Direction     | Entity                        |
| ------------- | ----------------------------- |
| Bidirectional | Arya lists ↔ Notion databases |
| Bidirectional | Records ↔ pages               |
| Bidirectional | Mapped custom fields          |

## Use in workflows

Once connected, Notion appears as an action in the [workflow builder](/en/automations/workflow-builder). You can:

* Trigger workflows from Notion events
* Use Notion as an action (e.g. create record, send message)

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authorisation error">
    Expired or revoked token. Disconnect and reconnect.
  </Accordion>

  <Accordion title="Slow or failed sync">
    Check service API quota (rate limit). Reduce frequency if exceeding quota.
  </Accordion>

  <Accordion title="Data not synced">
    Verify field mapping and filters. Try manual sync from **⋯ → Sync now**.
  </Accordion>

  <Accordion title="Duplicate errors">
    Arya uses unique keys for matching. Configure key (email, external ID) in **Settings → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnect

<Warning>
  Disconnection immediately stops synchronisation. Already-imported data stays in the workspace.
</Warning>

<Steps>
  <Step title="Go to Settings → Integrations">Find the Notion card.</Step>
  <Step title="Click Disconnect">Confirm. Access token is revoked.</Step>
</Steps>