How to Save Contact Form Submissions to a Notion Database

What You'll Need

• Your Macaly project chat
• An account with Notion

Step-by-Step Instructions

We'll do this in two parts: first, we'll get everything ready in Notion, and second, we'll tell Macaly how to connect to it.

Part 1: Set Up Your Notion Database & Integration

1. 1

   Create a new database in Notion. In your Notion workspace, create a new blank page and choose the Database - Full page option. Name it something like "My Contacts".
2. 2

   Add columns for your form fields. By default, you'll have a "Name" column. Add two more columns with the "Text" property type and name them "Email" and "Message".

A Notion database with three columns: Name, Email, and Message.

3. 3

   Create a new Notion integration. Open a new tab and go to www.notion.so/my-integrations. Click the + New integration button.
4. 4

   Configure your integration. Give your integration a name (like "Macaly Website") and associate it with your workspace. Make sure "Internal Integration" is selected and click Submit.
5. 5

   Set the integration's permissions. On the next screen, under "Capabilities," make sure the integration can Read content and Insert content.
6. 6

   Copy your secret API key. On the same page, find the "Secrets" section. Click Show and then Copy your "Internal Integration Token". This is your API key. Keep it safe!

The Notion integration settings page with the 'Internal Integration Token' highlighted.

7. 7

   Connect the integration to your database page. Go back to the "My Contacts" database you created in Notion. Click the three-dots menu (...) in the top-right corner, scroll down to + Add connections, and select the integration you just made (e.g., "Macaly Website").

The Notion integration connected with the Notion page

8. 8

   Copy the link to your database. Click the Share button in the top-right of your Notion page, then click Copy link.

Part 2: Connect Macaly to Notion

9. 9

   Tell Macaly to build and connect the form. Now for the magic. Go to your Macaly chat and send a single, detailed prompt. Be sure to paste in the API key and database link you just copied.

Tell Macaly:

Create a contact form with fields for name, email, and message. Connect this form to my Notion database. First, read the structure of the Notion page (use API) here: [paste your Notion database link here]. Use this API key to send the data: [paste your Notion API key here].

10. 10

    Test your new form. Once Macaly confirms the form is ready, open your website's preview or live page. Fill out the contact form with some sample information and click the submit button.

A contact form connected with Notion inside Macaly

11. 11

    Check your Notion database. Go back to your "My Contacts" database in Notion. You should see the information you just submitted appear as a new row!

A Quick Note on Security

Your Notion API key is like a secure password that lets Macaly talk to your Notion account. Keep it private and never share it publicly! Macaly stores it securely once you provide it.