Notion
Create a read-only Notion connection, share databases with it, and read data source rows as datasets, with Notion's limits and personal data rules.
A Notion connection reads the rows of the databases you share with it. In Notion, the thing you create for this is called a connection (Notion used to call it an integration). Xentropy only reads: it never changes your pages.
Availability
Notion is not yet generally available on xentropy.ai. Contact
support@xentropy.ai to request access. Until it is enabled for your account,
it does not appear in the catalogue and its reads fail with
PROVIDER_DISABLED.
Create a Notion connection
ntn_).Notion has no scopes to grant: the Read content capability and the databases you share decide what the connection can read.
Set up the connection
auth) and lists every data source shared with the connection.A Notion database can hold more than one data source. Each data source is listed and read on its own. Up to 500 data sources are listed.
Notion needs no IP allowlist: Xentropy connects only to api.notion.com.
Fields
Every row has page_id, url, created_time and last_edited_time, plus one
field per property:
| Notion property | Dataset type |
|---|---|
| Title, text | string, cut at 10,000 characters (VALUE_TRUNCATED warning) |
| Number | number |
| Select, status | string (the option name) |
| Multi-select, relation, files | JSON list, or comma-separated text |
| Date | date, or datetime when values have a time, plus a <name>_end field |
| Checkbox | boolean |
| People, created by, last edited by | names. Emails are separate personal data fields |
| Formula, rollup | by the result type |
| URL, unique ID, place | string |
| Email, phone | string, personal data |
| Created time, last edited time | datetime |
Button, verification and unknown property types are not read; the field picker
lists them. A formula or rollup that Notion cannot compute for the API becomes
empty, with a VALUE_UNSUPPORTED warning. File links are never stored: Notion
signs them and they expire.
When a value no longer fits its type
A dataset keeps the field types it was saved with. Dates, formulas and rollups
take their type from the values seen when you saved the dataset. If a later
value does not fit, for example text in a field saved as a number, the read
fails with TYPE_MISMATCH and names the field and row. Describe the data
source again and save the dataset with the new field type. A date without a
time in a datetime field is read as midnight UTC.
Personal data
Email and phone properties, and people emails (on people, created by and last edited by properties), are personal data. They are marked Personal data in the field picker and are off by default.
- If you select one, the dataset is marked as containing personal data
(
containsPii). The API and agents must confirm this withcontainsPii: true, otherwise the selection is refused.
Limits
| Limit | Value |
|---|---|
| Rows per read | 50,000, and at most 10,000 from Notion (see below) |
| Fields per dataset | 100 |
| Pages per read | Free 100, Pro 600 (100 rows per page) |
| Request rate | 2.5 requests per second per connection secret |
| Text per value | 10,000 characters |
| Related pages per relation value | 25 |
| Data sources listed | 500 |
| Read deadline | 30 s interactive, 300 s scheduled |
- Notion's 10,000-row cap. Notion returns at most 10,000 rows for one
query. When a data source has more, the read fails with
SOURCE_RESULT_LIMIT. Xentropy never treats such a read as complete. Add a filter in Notion, or split the data source. - Free plan. At 100 rows per page, Free reads stop at about 10,000 rows
with
LIMIT_EXCEEDED. - Relations. Notion returns up to 25 related pages per value. When a value
has more, the read carries a
RELATION_TRUNCATEDwarning. - People. Notion returns at most 25 people per value and does not say when it cut the list, so Xentropy cannot warn about it.
- Notion reads are paced at about 2.5 requests per second, so large data
sources take a while. Xentropy waits for Notion's
Retry-Afterwhen Notion is busy.
Errors
| Code | Cause | What to do |
|---|---|---|
PROVIDER_ACCESS_DENIED, stage auth | The secret was rejected | Copy the secret again, then replace the configuration |
NOT_FOUND | The database is no longer shared with the connection | In Notion, open the database, choose ••• → Connections and add the connection again |
SOURCE_RESULT_LIMIT | More than 10,000 matching rows, Notion's limit for one query | Add a filter in Notion, or split the data source |
LIMIT_EXCEEDED | More than the plan's pages, or 50,000 rows | Use a smaller data source, or upgrade to Pro |
RATE_LIMITED | Notion's rate limit or overload. details.retryAt says when to retry | Retry after retryAt |
TYPE_MISMATCH | A value does not fit the field type the dataset was saved with | Describe the data source again and save the dataset |
PERMISSION_DENIED | The data source is not selected on the connection | Select it, or replace the configuration |
VALIDATION_FAILED | Personal data selected without containsPii, or an invalid id | Fix the selection |
| Warning | Meaning |
|---|---|
RELATION_TRUNCATED | A relation value has more than 25 related pages; only 25 were read |
VALUE_TRUNCATED | Text longer than 10,000 characters was cut |
VALUE_UNSUPPORTED | Notion could not compute a formula or rollup value for the API; it is empty |
HubSpot
Connect HubSpot CRM with a service key, grant read scopes, and read contacts, companies, deals, tickets, custom objects, owners and pipelines.
Shopify
Connect a Shopify store with a Dev Dashboard app or an existing Admin API token, choose read scopes, and read orders, customers, products and inventory.