Home / Setup guide

How to connect Fieldclip to Notion

The quick way: click the Fieldclip icon, press Connect with Notion, and on Notion’s page tick the databases Fieldclip may save into. Done.

Prefer that no server is involved at all? Create a private connection in your own Notion workspace and give Fieldclip its token. The steps below take a couple of minutes.

What you need

• Fieldclip installed in Chrome (get it from the Chrome Web Store).
• A Notion workspace where you can create connections.
• A Notion database to clip into. Any database works, for example a reading list or a job tracker.

Step 1: Create an internal connection

1. Open app.notion.com/developers/connections and sign in to Notion if asked.
2. Go to Build → Internal connections.
3. Click Create a new connection.
4. Name it Fieldclip (any name works, but this one is easy to find later) and pick the workspace that holds your database.
5. Save the connection.

Step 2: Copy the API token

1. Open the connection you just created and go to its Configuration tab.
2. Find the API token, reveal it, and copy it. It usually starts with ntn_.

Treat this token like a password. Anyone who has it can add pages to the databases you share with the connection.

Step 3: Share your database with the connection

A new connection can't see anything until you share pages with it.

1. In Notion, open the database you want to clip into (as a full page).
2. Click the ••• menu in the top-right corner.
3. Choose Connections, search for Fieldclip, and add it. Confirm if Notion asks.

Repeat this for each database you want to use. On the Free plan, Fieldclip saves into one database; using more databases is part of Pro (US$3/month or US$24/year).

Step 4: Paste the token in Fieldclip

1. Click the Fieldclip icon in the Chrome toolbar. (If you don't see it, click the puzzle-piece icon and pin Fieldclip.)
2. Paste the token into the API token field and click Connect.
3. Fieldclip lists the databases shared with your connection. Pick one, and you're ready to clip.

Your token is stored only in this browser. Fieldclip sends it only to the official Notion API.

Troubleshooting

These are the messages Fieldclip shows when something goes wrong, and what to do about each one.

"Notion rejected the token. Copy the API token again from your Notion connection settings."

Notion didn't accept the token (HTTP 401). Usually a character was missed while copying, extra spaces were pasted, or the token was refreshed or the connection was deleted. Open the connection's Configuration tab, copy the API token again, and paste it into Fieldclip.

"This database is not shared with your connection. In Notion, open the database, click ••• → Connections and add Fieldclip."

The connection can't see the database (HTTP 404). Do Step 3 again for this database. If you created the connection in a different workspace than the database, create a new connection in the right workspace. After sharing, click the ↻ button next to the database picker in Fieldclip to reload the list.

"Your connection is not allowed to add pages. Turn on "Insert content" in the connection capabilities."

The connection can read but not write (HTTP 403). Open the connection in Notion, turn on Insert content in its capabilities, save, and try again.

"Notion could not accept one of the fields: …"

Notion refused one of the values (a validation error). The rest of the message says which field. Common causes: a column was renamed or its type changed after Fieldclip loaded it, or a value doesn't fit the column (for example text in a number column). Click ↻ to reload the database columns, fix or clear the value in that field, or change its source to "(leave empty)", then save again.

"Notion is busy right now. Wait a few seconds and try again."

Notion is rate-limiting requests (HTTP 429). Wait a few seconds and press Save again.

"Could not reach Notion. Check your internet connection and try again."

The request never got an answer from Notion. Check your connection, VPN, or any network filter that might block api.notion.com, then try again.

I don't see my database in the list

Only databases shared with the connection appear. Share it (Step 3), then click ↻ in Fieldclip. If you use more than one database on the Free plan, the others are marked Pro.

How do I disconnect?

Delete the connection in Notion, or remove it from a database through ••• → Connections. To remove the token from your browser, uninstall Fieldclip or clear its data in Chrome settings.