Skip to content
Nappai Documentation

Update Page Property

⚠️ DEPRECATION WARNING

This component is deprecated and will be removed in a future version of Nappai. Please migrate to the recommended alternative components.

This component lets you change the properties of a page in Notion. You give it the page’s ID and the new values, and it updates the page for you.

How it Works

When you run the component, it builds a small HTTP request that talks to Notion’s public API.

  1. Authentication – It uses the Notion integration token that you have stored in Nappai’s credential system.
  2. Request – It sends a PATCH request to https://api.notion.com/v1/pages/{page_id} with the properties you supplied.
  3. Response – If the request succeeds, the component returns the updated page data. If something goes wrong, it gives you a clear error message.

Because it talks to an external service, the component needs an internet connection and the correct permissions on the Notion integration.

Inputs

Input Fields

  • Page ID: The ID of the Notion page to update.
  • Properties: The properties to update on the page (as a JSON string or a dictionary).

Credential requirement
This component needs a Notion API credential.

  1. In Nappai, go to Credentials and create a new Notion API credential.
  2. Provide the Notion Integration Token (you can create one in the Notion developer portal).
  3. In the component, select that credential in the Credential field.

Outputs

  • Data: Returns a Data object that contains a readable text summary of the updated properties and the raw JSON data of the page.
  • Tool: Returns a Tool object that can be used by agents to perform the same update operation programmatically.

Usage Example

  1. Add the component to your workflow.
  2. Set the Page ID to the ID of the page you want to change (e.g., abcd1234).
  3. Enter Properties as a JSON string, for example: 
    {
      "Title": { "title": [{ "text": { "content": "New Title" } }] },
      "Status": { "select": { "name": "In Progress" } }
    }
  4. Select the Notion API credential you created earlier.
  5. Run the workflow.
  6. The Data output will show something like: 
    Updated page properties:
    Title: New Title
    Status: In Progress
  • NotionPageCreate – Create a new page in a Notion database.
  • NotionPageRetrieve – Get the current properties of a page.
  • NotionDatabaseList – List all databases in your Notion workspace.

Tips and Best Practices

  • Validate JSON – Use a JSON validator before pasting the properties to avoid syntax errors.
  • Test with a copy – Try updating a duplicate page first to confirm the changes.
  • Use small updates – Updating many properties at once can hit rate limits; split large updates into smaller batches if needed.
  • Keep the token secret – Never expose the integration token in public code or logs.

Security Considerations

  • The Notion integration token grants write access to your pages. Store it securely in Nappai’s credential store and avoid sharing it.
  • The component logs request URLs and payloads for debugging; ensure that logs are protected and do not expose sensitive data.