Ziflow administrators can integrate Ziflow with Notion and create an automation flow so that every new proof in Ziflow automatically creates a row in a Notion database.

Requirements

• You must be an owner of the Notion workspace where you want to create the integration.
• You must be a Ziflow administrator

Set up your Notion database

Find your database ID

Create an integration with Notion

Get your API key & connect your page

Create an automation flow in Ziflow

Test your flow

Set up your Notion database

Your Notion table must match your information in Ziflow in order for Ziflow to create a new row.

1. Add a page to your Notion and create an empty database.
2. Name and format the columns:
   First column: "Proof Name"
   Second column: "Version" and select type Text
   Third column: "Proof Status" and select type Select
   Fourth column: "Proof Link" and select type URL
   
   

Find your database ID

You will need the database ID to set up your webhook later.

Notion uses the database ID in the URL. With your database open in your browser, look at the top of the page.

Example:

If URL is https://www.notion.so/ziflow/JyFykVNLJIkq2cwLjrhOWb4kquzMbLcF?v=lg5hwPoE1Y0Z0TOZnKir5GYKV3ZaLygn 

• The database ID between the last / and ? in the URL

• In this example, the database ID is: JyFykVNLJIkq2cwLjrhOWb4kquzMbLcF

Create an integration with Notion

Get your API key & connect your page

1. In Notion, select Settings under the top-left arrow.
   
   
   ​
2. Select Connections > Develop or manage integrations.
   
   
   
   
3. Select New integration and fill in the fields.
   
   
   
   Integration name: Enter what you want to call the integration, such as "Ziflow integration".
   Associated workspace: The workspace where the integration will run.
   Type: Choose Internal or Public.
   Logo: Upload a logo (optional)
   
   Note: If no workspaces appear in the Associate workspace drop-down list, you are not an owner on any workspaces.
   
   
4. Select Save.​
   You will see a message that the integration is successful.
   
   
   
   
5. Select Configure integration settings.
   The Configure integrations settings page contains the Internal Integration Secret (your API key). To use your API key to send updates to a particular page in Notion, you need to connect the page you want to update.
6. Select the Access tab and choose the pages or database you want to integrate with Ziflow.
   
   
   
   You can also connect an integration directly from a Notion page: open the page, select the three dots in the top-right corner, and choose Connections > [the name you gave the new integration].
   
   

Create an automation flow in Ziflow

This flow will add a row to your database when a new proof is created. For basic information about automation flows, see Understand automation flows (Connect).

Requirements: If you have not connected the Ziflow app, see Connect your Ziflow app.

1. Open Ziflow and go to the Connect tab.
2. Select Create Flow.
3. Select Ziflow as your application.
   
   
   
   
4. Select New proof/version as your event.
5. Select how you want the flow to start. To create a new row every time a new proof is created, for example, choose New proof. For more information about configuring this event, see Ziflow events.
6. Select Next.
7. Under Choose a Zibot, select Webhook.
8. Configure your webhook.
   
   

   Field	Description
   Create	POST
   URL	https://api.notion.com/v1/pages
   Request body	Replace the database_id with your database ID.  { "parent": { "type": "database_id", "database_id": "JyFykVNLJIkq2cwLjrhOWb4kquzMbLcF"}, "properties": { "Proof Name": {"title": [{"text": {"content": "{$.proof.name}"}}]}, "Proof Link": {"url": "{$.proof.public_link}"}, "Version": {"rich_text": [{"text": {"content": "v{$.proof.version}"}}]}, "Proof Status": {"select": {"name": "In Progress"}} }} This is the information used to fill in the table columns you set up earlier, which is why the column names and type of information have to match.
   Headers	Add two key-value pairs: "Authorization"    "Bearer" YOUR API KEY  "Notion-Version"    The API version (currently "2025-09-03")

   
   To reference different property types, see https://developers.notion.com/reference/property-object
   ​You can reference properties with their ID or the name of them (we used name)
   
   
   
   
9. Select Next. 
10. Select Save & Turn on.

Test your flow

1. Create a new proof in Ziflow that matches the event configuration. 
2. Verify that a new row appears in your Notion database with the proof details.