Get started with the Notiondesk REST API

The Notiondesk REST API lets your own code operate your help centers. You can list your help centers, read their articles, collections and changelog, manage page redirects, change settings and branding, pull analytics and reader feedback, and trigger syncs from Notion.

This article explains what the Notiondesk API can do, who can use it, and how to make your first request in a few minutes.

What you can do with the Notiondesk API

For ready-to-use scripts, see Automate common help center tasks with the Notiondesk API.

Who can use the Notiondesk API

• Plan: API access is included in the Enterprise plans.

• Creating keys: Workspace owners and Admins create API keys in the dashboard.

• Permissions: A key or an app can never do more than the person behind it can do in your workspace. See Authenticate with the Notiondesk API using API keys.

Make your first Notiondesk API request

1. Create an API key

In your Notiondesk dashboard, open Settings, then Developers > API keys, and click Create key. Give it a label, select the read scope, and copy the key when it is shown. The key starts with nd_wsk_ and is shown only once.

Store it in an environment variable:

export NOTIONDESK_API_KEY="nd_wsk_..."

2. List your help centers

curl "<https://api.notiondesk.so/sites>" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

The response lists every help center in your workspace:

{
  "object": "list",
  "data": [
    {
      "id": "c74781f6-1aea-4e17-ab23-bbb8b4d174b6",
      "full_domain": "help.example.com",
      "enabled": true,
      "default_locale": "en",
      "locales": ["en", "fr"]
    }
  ],
  "has_more": false,
  "next_cursor": null
}

3. List the articles of a help center

curl "<https://api.notiondesk.so/sites/c74781f6-1aea-4e17-ab23-bbb8b4d174b6/articles?page_size=10>" \
  -H "Authorization: Bearer $NOTIONDESK_API_KEY" \
  -H "nd-version: 2026-10-16"

That's it! You are reading your help center from code.

Notiondesk API basics

Notiondesk API or Workspace MCP?

Notiondesk offers two ways to operate your help centers outside the dashboard. They reach the same features through different doors.

Notiondesk API endpoint

Common questions

What's next

• Authenticate with the Notiondesk API using API keys

• Connect your app to Notiondesk with OAuth

• Handle Notiondesk API errors, rate limits, and retries

• Automate common help center tasks with the Notiondesk API