> For the complete documentation index, see [llms.txt](https://www.cakewalk.security/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.cakewalk.security/docs/human-access/connections-and-integrations/integration-guides/notion.md).

# Notion

Set up Notion auto-provisioning with a workspace owner account or Google sign-in, plus access sync through OAuth.

### :sparkles: Auto Provisioning

| **Authentication method** | Username & password, or a connected Google account. See [Sign in with Google](/docs/human-access/how-to-guides/auto-provisioning/how-it-works/sign-in-with-google.md). |
| ------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Required permissions**  | `Workspace owner`                                                                                                                                                      |
| **Required metadata**     | None                                                                                                                                                                   |
| **MFA**                   | Required with `Username & password`. Not used with `Sign in with Google`. Setup details [here](#how-to-enable-mfa).                                                    |
| **Email verification**    | Optional with `Username & password`. Not used with `Sign in with Google`.                                                                                              |

{% hint style="info" %}
**Signing in with Google:** if your Notion workspace owner signs in through Google, choose **Sign in with Google** on the Sign-in method step and pick a connected account. Notion then has no separate password, MFA secret or emailed code to configure. See [Sign in with Google](/docs/human-access/how-to-guides/auto-provisioning/how-it-works/sign-in-with-google.md).
{% endhint %}

<details>

<summary><strong>How to enable MFA</strong></summary>

1\. Select your workspace in Notion.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/7ef00b9f-be42-481c-8bd5-ed788a0d20c4/user_cropped_screenshot_b6a949ac155b4feb9074d49e8a2d73ea_text_export.jpeg)

2\. Click `Settings`.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/49f552ba-bff0-426e-aa73-d84633038ba5/user_cropped_screenshot_1c144ea00f8e46bc8bc466ecd635566e_text_export.jpeg)

3\. Open the profile section of your account settings.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/3db8aa03-b34b-4941-be32-ab3821081e19/ascreenshot_6d4e5600b61e4a6887b0c24eca73fcc2_text_export.jpeg)

4\. Click `Add verification method`.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/6ee9fc89-eecc-4c34-b05d-89d695d75a09/ascreenshot_59dbbffcd9c443239b8ae8c5ec013f91_text_export.jpeg)

5\. Select the authenticator app option.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/f6558f47-597d-4e3d-b5ba-2b3421b98654/ascreenshot_ee232e81a01b43d6a32c8bff2cc9e78e_text_export.jpeg)

6\. Click `Can't scan code?` to reveal the manual setup key.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/27cbff24-ecdd-4e1d-b415-20ae17fc6a56/ascreenshot_3a24bf29da664664b7232485036216ec_text_export.jpeg)

7\. Copy the manual setup secret shown in Notion.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/5ae544ee-a9af-4200-8efe-580afee5a969/ascreenshot_6a2542702d1547639cf5906fcd330053_text_export.jpeg)

8\. Navigate back to Cakewalk and paste it into the `MFA Secret` field.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/59b3ebd6-7889-45e2-b44e-ad7caac61485/ascreenshot_f783a0b5f8684a04af81fb42c59f0e7e_text_export.jpeg)

9\. Copy the auto-generated `One-Time Password` from Cakewalk.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/f4356e91-8cec-4da3-9e02-2f4c78f93beb/ascreenshot_5bff0dd79f8e4a8f8f79fc2be82608b2_text_export.jpeg)

10\. Navigate back to Notion and paste the `One-Time Password` into the corresponding field.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/0e3e76fe-ca74-4922-a969-1d62a203c0aa/ascreenshot_24047c82fc2a412c97c7380dc6e04458_text_export.jpeg)

11\. Name the authenticator `Cakewalk`.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/fd7f9473-8571-42e1-8673-e1ab04bf98bc/ascreenshot_a0198b21d5f54e41936dc74a1df1b8fe_text_export.jpeg)

12\. Click `Continue`.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/c425bcb9-b477-4211-b2d6-9e5f7456fa39/ascreenshot_017490eb453048af958fd9da9b8b3c43_text_export.jpeg)

13\. Confirm that you have saved your backup codes to complete the setup.

![](https://colony-recorder.s3.amazonaws.com/files/2026-07-07/76bb452c-de01-488d-90e4-ef51e9dce7a9/ascreenshot_f95bc6e9cb9f4097bf25883c29cb7d99_text_export.jpeg)

</details>

***

### :arrows\_counterclockwise: Access Sync

Access Sync for Notion allows you to automatically synchronize user data with Cakewalk.

| **Authentication method**  | OAuth          |
| -------------------------- | -------------- |
| **Synced user attributes** | Email and Name |

## Quick Setup

1. Navigate to **App Governance** → **Notion** → **Users table** → **Sync Users**
2. Grant Cakewalk OAuth access to your Notion account
3. Users will sync automatically


---

# 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://www.cakewalk.security/docs/human-access/connections-and-integrations/integration-guides/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.