3. Setup
The Notion API uses special API accounts that can be added to pages. This creates a two-way trust that only allows a specific API user account with a specific API key to access a specific page. The OPSEC here is great!
First, head to https://developers.notion.com/ and log in with your regular Notion account.
Next, click on "My integrations" in the upper-right corner:
Click on "New integration":
Enter a name in the "Name" field. Ensure the Associated workspace is the Notion account that you want to use for your operation. You can leave the remaining fields as default and click "Submit":
Your developer API key is the value in the "Internal Integration Token" field, which is obscured by dots. Copy this down and keep it handy!
The "listener" is just a page in a Notion notebook. But you can set it up to catch the callbacks for your agents:
Create your listener page. Add a new page to Notion, preferably in a notebook that's not being used for anything else:
In the upper right corner, click "Share" and "Invite". Add your Notion Developer API account to this page:
Copy the URL of your page down. If you're in the web browser Notion client, this can be taken from the URL of the page. In the desktop app, enter ctl-l to copy it to your clipboard.
If your listener URL is:
https://www.notion.so/LISTENER-11223344556677889900112233445566
... then your parent page ID is the number after the name of the listener. In this case, it is 11223344556677889900112233445566. This value is used to connect your agent to your listener, so keep track of it!
You are now ready to run the agent!