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

# Notion

> Let your users connect Notion. Constella keeps it in sync.

| | |
| - | - |
| Integration name | `notion` |
| What syncs | Pages and databases the user shares with Constella when they connect. |
| What your app can do | Search pages, read a page, add or update pages. See the exact list with [List actions](/dev/docs/api-reference/apps/list-actions.md). |

## Connect a user

```bash theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/connect-links \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"integration": "notion", "return_url": "https://yourapp.com/connected"}'
```

Send the user to the `url` you get back. When the first sync is done, your [webhook](/dev/docs/build/webhooks.md) gets `sync.initial_completed`. The whole flow is in [Sync your users' apps](/dev/docs/build/sync-apps.md).

## Find what synced

```bash theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/search \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["project kickoff"], "integrations": ["notion"]}'
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.