`tags.notion.preview`

Read a Notion page or database row before linking it to a project: supply page (a notion.so link or page ID) and, for an existing project, tagId. Returns its title, whether it is a row and in which database, suggested properties for dates, status, budget and description with every property that could hold each (choices) and the value each would read (propertyValues), the start of the page text the classifier would use, any problems, and with tagId the project's own values and what the first sync would change for each source of truth (firstSync). Review it, then pass the properties you chose to accounting_tags_notion_link.

GETPOST/api/v1/accounting/tags.notion.preview

Permissions

accounting:read

Who can call it

admin, finance

Retries

Safe to retry: it only reads

MCP

accounting_tags_notion_preview

Reaches outside Oatmilk

It emails people or calls another service.

Fields

pagestringRequired
1–2000 characters
tagIdstring (ID)
The ID of a project tag, from tags.list.

curl -G https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'page=example'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview?page=example", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "page": "example",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Response

{
  "data": { … }
}

Try it

Checks your input with this action’s real schema and answers like the API, with synthetic data. No key needed, and nothing changes.

Input

GET/api/v1/accounting/tags.notion.preview

curl -G https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview \
  -H "Authorization: Bearer $OATMILK_API_KEY" \
  --data-urlencode 'page=example'

const response = await fetch("https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview?page=example", {
  headers: {
    Authorization: `Bearer ${process.env.OATMILK_API_KEY}`,
  },
});
const { data, error } = await response.json();
if (!response.ok) throw new Error(`${error.code}: ${error.message}`);
console.log(data);

import os

import requests

response = requests.get(
    "https://app.getoatmilk.com/api/v1/accounting/tags.notion.preview",
    headers={
        "Authorization": f"Bearer {os.environ['OATMILK_API_KEY']}",
    },
    params={
        "page": "example",
    },
    timeout=30,
)
payload = response.json()
if not response.ok:
    raise RuntimeError(f"{payload['error']['code']}: {payload['error']['message']}")
print(payload["data"])

Fields

Example

Try it