← Notion + Kontent.ai integrations

Create Content Item with Kontent.ai API on Updated Page in Database from Notion API

Pipedream makes it easy to connect APIs for Kontent.ai, Notion and 2,400+ other apps remarkably fast.

Trigger workflow on
Updated Page in Database from the Notion API
Next, do this
Create Content Item with the Kontent.ai API
No credit card required
Intro to Pipedream
Watch us build a workflow
Watch us build a workflow
8 min
Watch now ➜

Trusted by 1,000,000+ developers from startups to Fortune 500 companies

Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo
Adyen logo
Appcues logo
Bandwidth logo
Checkr logo
ChartMogul logo
Dataminr logo
Gopuff logo
Gorgias logo
LinkedIn logo
Logitech logo
Replicated logo
Rudderstack logo
SAS logo
Scale AI logo
Webflow logo
Warner Bros. logo

Developers Pipedream

Getting Started

This integration creates a workflow with a Notion trigger and Kontent.ai action. When you configure and deploy the workflow, it will run on Pipedream's servers 24x7 for free.

  1. Select this integration
  2. Configure the Updated Page in Database trigger
    1. Connect your Notion account
    2. Configure timer
    3. Select a Database ID
    4. Configure Include New Pages
    5. Optional- Select one or more Property Types
    6. Configure alert
  3. Configure the Create Content Item action
    1. Connect your Kontent.ai account
    2. Configure Name
    3. Optional- Configure Codename
    4. Select a Type Id
    5. Optional- Select a Collection Id
    6. Optional- Configure External Id
  4. Deploy the workflow
  5. Send a test event to validate your setup
  6. Turn on the trigger

Details

This integration uses pre-built, source-available components from Pipedream's GitHub repo. These components are developed by Pipedream and the community, and verified and maintained by Pipedream.

To contribute an update to an existing component or create a new component, create a PR on GitHub. If you're new to Pipedream component development, you can start with quickstarts for trigger span and action development, and then review the component API reference.

Trigger

Description:Emit new event when a page in a database is updated. To select a specific page, use `Updated Page ID` instead
Version:0.1.4
Key:notion-updated-page

Notion Overview

Notion's API allows for the creation, reading, updating, and deleting of pages, databases, and their contents within Notion. Using Pipedream's platform, you can build workflows that connect Notion with various other services to automate tasks such as content management, task tracking, and data synchronization. With Pipedream's serverless execution, you can trigger these workflows on a schedule, or by external events from other services, without managing any infrastructure.

Trigger Code

import notion from "../../notion.app.mjs";
import sampleEmit from "./test-event.mjs";
import base from "../common/base.mjs";
import constants from "../common/constants.mjs";
import zlib from "zlib";

export default {
  ...base,
  key: "notion-updated-page",
  name: "Updated Page in Database", /* eslint-disable-line pipedream/source-name */
  description: "Emit new event when a page in a database is updated. To select a specific page, use `Updated Page ID` instead",
  version: "0.1.4",
  type: "source",
  dedupe: "unique",
  props: {
    ...base.props,
    databaseId: {
      propDefinition: [
        notion,
        "databaseId",
      ],
    },
    includeNewPages: {
      type: "boolean",
      label: "Include New Pages",
      description: "Set to `true` to emit events when pages are created. Set to `false` to ignore new pages.",
      default: true,
    },
    properties: {
      propDefinition: [
        notion,
        "propertyTypes",
        (c) => ({
          parentId: c.databaseId,
          parentType: "database",
        }),
      ],
      description: "Only emit events when one or more of the selected properties have changed",
      optional: true,
    },
    alert: {
      type: "alert",
      alertType: "info",
      content: "Source not saving? Your database might be too large. If deployment takes longer than one minute, an error will occur.",
    },
  },
  hooks: {
    async activate() {
      console.log("Activating: fetching pages and properties");
      this._setLastUpdatedTimestamp(Date.now());
      const propertyValues = {};
      const propertiesToCheck = await this._getPropertiesToCheck();
      const params = this.lastUpdatedSortParam();
      const pagesStream = this.notion.getPages(this.databaseId, params);
      for await (const page of pagesStream) {
        for (const propertyName of propertiesToCheck) {
          const currentValue = this._maybeRemoveFileSubItems(page.properties[propertyName]);
          propertyValues[page.id] = {
            ...propertyValues[page.id],
            [propertyName]: currentValue,
          };
        }
      }
      this._setPropertyValues(propertyValues);
    },
    async deactivate() {
      console.log("Deactivating: clearing states");
      this._setLastUpdatedTimestamp(null);
    },
  },
  methods: {
    ...base.methods,
    _getLastUpdatedTimestamp() {
      return this.db.get(constants.timestamps.LAST_EDITED_TIME);
    },
    _setLastUpdatedTimestamp(ts) {
      this.db.set(constants.timestamps.LAST_EDITED_TIME, ts);
    },
    _getPropertyValues() {
      const compressed = this.db.get("propertyValues");
      const buffer = Buffer.from(compressed, "base64");
      const decompressed = zlib.inflateSync(buffer).toString();
      return JSON.parse(decompressed);
    },
    _setPropertyValues(propertyValues) {
      const string = JSON.stringify(propertyValues);
      const compressed = zlib.deflateSync(string).toString("base64");
      this.db.set("propertyValues", compressed);
    },
    async _getPropertiesToCheck() {
      if (this.properties?.length) {
        return this.properties;
      }
      const { properties } = await this.notion.retrieveDatabase(this.databaseId);
      return Object.keys(properties);
    },
    _maybeRemoveFileSubItems(property) {
      // Files & Media type:
      // `url` and `expiry_time` are constantly updated by Notion, so ignore these fields
      if (property.type === "files") {
        const modified = structuredClone(property);
        for (const file of modified.files) {
          if (file.type === "file") {
            delete file.file;
          }
        }
        return modified;
      }
      return property;
    },
    _generateMeta(obj, summary) {
      const { id } = obj;
      const title = this.notion.extractPageTitle(obj);
      const ts = Date.now();
      return {
        id: `${id}-${ts}`,
        summary: `${summary}: ${title}`,
        ts,
      };
    },
    _emitEvent(page, changes = [], isNewPage = true) {
      const meta = isNewPage
        ? this._generateMeta(page, constants.summaries.PAGE_ADDED)
        : this._generateMeta(page, constants.summaries.PAGE_UPDATED);
      const event = {
        page,
        changes,
      };
      this.$emit(event, meta);
    },
  },
  async run() {
    const lastCheckedTimestamp = this._getLastUpdatedTimestamp();
    const propertyValues = this._getPropertyValues();

    if (!lastCheckedTimestamp) {
      // recently updated (deactivated / activated), skip execution
      console.log("Awaiting restart completion: skipping execution");
      return;
    }

    const params = {
      ...this.lastUpdatedSortParam(),
      filter: {
        timestamp: "last_edited_time",
        last_edited_time: {
          on_or_after: new Date(lastCheckedTimestamp).toISOString(),
        },
      },
    };
    let newLastUpdatedTimestamp = lastCheckedTimestamp;
    const propertiesToCheck = await this._getPropertiesToCheck();
    const pagesStream = this.notion.getPages(this.databaseId, params);

    for await (const page of pagesStream) {
      const changes = [];
      let isNewPage = false;
      let propertyHasChanged = false;

      newLastUpdatedTimestamp = Math.max(
        newLastUpdatedTimestamp,
        Date.parse(page.last_edited_time),
      );

      if (lastCheckedTimestamp > Date.parse(page.last_edited_time)) {
        break;
      }

      for (const propertyName of propertiesToCheck) {
        const previousValue = structuredClone(propertyValues[page.id]?.[propertyName]);
        // value used to compare and to save to this.db
        const currentValueToSave = this._maybeRemoveFileSubItems(page.properties[propertyName]);
        // (unmodified) value that should be emitted
        const currentValueToEmit = page.properties[propertyName];

        const pageExistsInDB = propertyValues[page.id] != null;
        const propertyChanged =
          JSON.stringify(previousValue) !== JSON.stringify(currentValueToSave);

        if (pageExistsInDB && propertyChanged) {
          propertyHasChanged = true;
          propertyValues[page.id] = {
            ...propertyValues[page.id],
            [propertyName]: currentValueToSave,
          };
          changes.push({
            property: propertyName,
            previousValue,
            currentValue: currentValueToEmit,
          });
        }

        if (!pageExistsInDB) {
          isNewPage = true;
          propertyHasChanged = true;
          propertyValues[page.id] = {
            [propertyName]: currentValueToSave,
          };
          changes.push({
            property: propertyName,
            previousValue,
            currentValue: currentValueToEmit,
          });
        }
      }

      if (isNewPage && !this.includeNewPages) {
        console.log(`Ignoring new page: ${page.id}`);
        continue;
      }

      if (propertyHasChanged) {
        this._emitEvent(page, changes, isNewPage);
      }
    }

    this._setLastUpdatedTimestamp(newLastUpdatedTimestamp);
    this._setPropertyValues(propertyValues);
  },
  sampleEmit,
};

Trigger Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI and CLI.
LabelPropTypeDescription
NotionnotionappThis component uses the Notion app.
N/Adb$.service.dbThis component uses $.service.db to maintain state between executions.
timer$.interface.timer
Database IDdatabaseIdstringSelect a value from the drop down menu.
Include New PagesincludeNewPagesboolean

Set to true to emit events when pages are created. Set to false to ignore new pages.

Property Typespropertiesstring[]Select a value from the drop down menu.

Trigger Authentication

Notion uses OAuth authentication. When you connect your Notion account, Pipedream will open a popup window where you can sign into Notion and grant Pipedream permission to connect to your account. Pipedream securely stores and automatically refreshes the OAuth tokens so you can easily authenticate any Notion API.

Pipedream requests the following authorization scopes when you connect your account:

About Notion

Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.

Action

Description:Create a new content item based on a specific content type. [See the documentation](https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#operation/add-a-content-item)
Version:0.0.1
Key:kontent_ai-create-content-item

Kontent.ai Overview

The Kontent.ai API offers robust content management capabilities for developers to manage and deliver content across various platforms. With this API, you can automate content creation, update content items, retrieve assets, and sync your content with other services. On Pipedream, you can harness these features to create powerful workflows that trigger on specific events, process data, and connect with other apps to streamline your content operations.

Action Code

import kontentAi from "../../kontent_ai.app.mjs";

export default {
  key: "kontent_ai-create-content-item",
  name: "Create Content Item",
  version: "0.0.1",
  description: "Create a new content item based on a specific content type. [See the documentation](https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#operation/add-a-content-item)",
  type: "action",
  props: {
    kontentAi,
    name: {
      type: "string",
      label: "Name",
      description: "The content item's display name.",
    },
    codename: {
      type: "string",
      label: "Codename",
      description: "If not defined, it is [initially generated](https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#section/Rules-for-codenames) from the item's **name** and can later be modified.",
      optional: true,
    },
    typeId: {
      propDefinition: [
        kontentAi,
        "typeId",
      ],
    },
    collectionId: {
      propDefinition: [
        kontentAi,
        "collectionId",
      ],
      optional: true,
    },
    externalId: {
      type: "string",
      label: "External Id",
      description: "The content item's external ID. The external ID can be used as a unique identifier to retrieve content from a different system.",
      optional: true,
    },
  },
  async run({ $ }) {
    const {
      kontentAi,
      typeId,
      collectionId,
      externalId,
      ...data
    } = this;

    let collection = {};
    if (collectionId) {
      collection = {
        collection: {
          id: collectionId,
        },
      };
    }

    const { data: response } = await kontentAi.createContentItem({
      ...data,
      type: {
        id: typeId,
      },
      ...collection,
      externalId,
    });

    $.export("$summary", `A new content item with Id: ${response.id} was successfully created!`);
    return response;
  },
};

Action Configuration

This component may be configured based on the props defined in the component code. Pipedream automatically prompts for input values in the UI.

LabelPropTypeDescription
Kontent.aikontentAiappThis component uses the Kontent.ai app.
Namenamestring

The content item's display name.

Codenamecodenamestring

If not defined, it is initially generated from the item's name and can later be modified.

Type IdtypeIdstringSelect a value from the drop down menu.
Collection IdcollectionIdstringSelect a value from the drop down menu.
External IdexternalIdstring

The content item's external ID. The external ID can be used as a unique identifier to retrieve content from a different system.

Action Authentication

Kontent.ai uses API keys for authentication. When you connect your Kontent.ai account, Pipedream securely stores the keys so you can easily authenticate to Kontent.ai APIs in both code and no-code steps.

To retrieve your API keys,

  • Navigate to your Kontent.ai account and sign in
  • Click the User menu on the left bottom
  • Go to “Projects.”
  • On one of your projects click “Open Project.”
  • Click the Environment menu located on the second column at the top
  • Go to “API Keys.”
  • Create a new key under "Management API keys" or "Delivery API keys" tab, depending on the Kontent.ai API you'd like to connect via Pipedream

To retrieve your Environment ID,

  • Navigate to your Kontent.ai account and sign in
  • Click the User menu on the left bottom
  • Go to “Projects”
  • On one of your projects click “Open Project”
  • Click the Environment menu located on the second column at the top
  • On one of your environments, click the More Actions option with the three dots (“Open Project”)
  • Go to “Environment Settings.”

About Kontent.ai

Complete control over your content. Kontent AI is the headless CMS that enables organizations to govern all things content to deliver standout experiences.

More Ways to Connect Kontent.ai + Notion

Create Content Item with Kontent.ai API on Updated Page ID from Notion API
Notion + Kontent.ai
 
Try it
Create Content Item with Kontent.ai API on New Page in Database from Notion API
Notion + Kontent.ai
 
Try it
Create Content Item with Kontent.ai API on New Database from Notion API
Notion + Kontent.ai
 
Try it
Create Content Item with Kontent.ai API on Page or Subpage Updated from Notion API
Notion + Kontent.ai
 
Try it
Find a Page with Notion API on New Content Item Moved (Instant) from Kontent.ai API
Kontent.ai + Notion
 
Try it
New Database from the Notion API

Emit new event when a database is created. Note: Databases must be shared with your Pipedream Integtration to trigger event.

 
Try it
New Page in Database from the Notion API

Emit new event when a page in a database is created

 
Try it
Page or Subpage Updated from the Notion API

Emit new event when a page or one of its sub-pages is updated.

 
Try it
Updated Page ID from the Notion API

Emit new event when a selected page is updated

 
Try it
Updated Page in Database from the Notion API

Emit new event when a page in a database is updated. To select a specific page, use Updated Page ID instead

 
Try it
Append Block to Parent with the Notion API

Creates and appends blocks to the specified parent. See the documentation

 
Try it
Create Page with the Notion API

Creates a page from a parent page. The only valid property is title. See the documentation

 
Try it
Create Page from Database with the Notion API

Creates a page from a database. See the documentation

 
Try it
Duplicate Page with the Notion API

Creates a new page copied from an existing page block. See the documentation

 
Try it
Find a Page with the Notion API

Searches for a page by its title. See the docs

 
Try it

Explore Other Apps

1
-
24
of
2,400+
apps by most popular

HTTP / Webhook
HTTP / Webhook
Get a unique URL where you can send HTTP or webhook requests
Node
Node
Anything you can do with Node.js, you can do in a Pipedream workflow. This includes using most of npm's 400,000+ packages.
Python
Python
Anything you can do in Python can be done in a Pipedream Workflow. This includes using any of the 350,000+ PyPi packages available in your Python powered workflows.
OpenAI (ChatGPT)
OpenAI (ChatGPT)
OpenAI is an AI research and deployment company with the mission to ensure that artificial general intelligence benefits all of humanity. They are the makers of popular models like ChatGPT, DALL-E, and Whisper.
Premium
Salesforce
Salesforce
Web services API for interacting with Salesforce
Premium
HubSpot
HubSpot
HubSpot's CRM platform contains the marketing, sales, service, operations, and website-building software you need to grow your business.
Premium
Zoho CRM
Zoho CRM
Zoho CRM is an online Sales CRM software that manages your sales, marketing, and support in one CRM platform.
Premium
Stripe
Stripe
Stripe powers online and in-person payment processing and financial solutions for businesses of all sizes.
Shopify
Shopify
Shopify is a complete commerce platform that lets anyone start, manage, and grow a business. You can use Shopify to build an online store, manage sales, market to customers, and accept payments in digital and physical locations.
Premium
WooCommerce
WooCommerce
WooCommerce is the open-source ecommerce platform for WordPress.
Premium
Snowflake
Snowflake
A data warehouse built for the cloud
Premium
MongoDB
MongoDB
MongoDB is an open source NoSQL database management program.
Supabase
Supabase
Supabase is an open source Firebase alternative.
MySQL
MySQL
MySQL is an open-source relational database management system.
PostgreSQL
PostgreSQL
PostgreSQL is a free and open-source relational database management system emphasizing extensibility and SQL compliance.
Premium
AWS
AWS
Amazon Web Services (AWS) offers reliable, scalable, and inexpensive cloud computing services.
Premium
Twilio SendGrid
Twilio SendGrid
Send marketing and transactional email through the Twilio SendGrid platform with the Email API, proprietary mail transfer agent, and infrastructure for scalable delivery.
Amazon SES
Amazon SES
Amazon SES is a cloud-based email service provider that can integrate into any application for high volume email automation
Premium
Klaviyo
Klaviyo
Email Marketing and SMS Marketing Platform
Premium
Zendesk
Zendesk
Zendesk is award-winning customer service software trusted by 200K+ customers. Make customers happy via text, mobile, phone, email, live chat, social media.
Notion
Notion
Notion is a new tool that blends your everyday work apps into one. It's the all-in-one workspace for you and your team.
Slack
Slack
Slack is a channel-based messaging platform. With Slack, people can work together more effectively, connect all their software tools and services, and find the information they need to do their best work — all within a secure, enterprise-grade environment.
Microsoft Teams
Microsoft Teams
Microsoft Teams has communities, events, chats, channels, meetings, storage, tasks, and calendars in one place.
Schedule
Schedule
Trigger workflows on an interval or cron schedule.