clothion offers an interface to create widgets for your Notion tables, but it’s also an API that allows you to easily access your Notion data.

There is three main API points, and this page describe in detail how to use these API points.

You can also check the Swagger docs at clothion.rémond.com/docs.

POST /create

Register an integration and a table.

If the registration is successful, the user is redirected to the widget creation page.

<aside> <img src="/icons/warning_gray.svg" alt="/icons/warning_gray.svg" width="40px" /> This API point is a bit special : on success, it will automatically redirect to the widget creation page.

</aside>

<aside> <img src="/icons/checkmark_gray.svg" alt="/icons/checkmark_gray.svg" width="40px" /> If you need to retrieve the integration ID / table ID (unique identifiers used in the path of the other API points), you can get it from the redirected URL (see example usage).

</aside>

Body parameters

integration string required

The integration token of the Notion integration that have access to the data.

table string required

The Notion table ID from where the data will be pulled.

Responses

• 301 Normal response, it’s a redirect to the widget creation page.
• 422 There was an error with the given integration and/or table ID, and the server couldn’t use the given credentials to retrieve the data from the Notion API.

Example usage

import requests

form_data = {"integration": "<secret_token>", "table": "<table_id>"}
response = requests.post("<https://clothion.rémond.com/create>", data=form_data)

# Retrieve the IDs necessary to call other API points (/xx/xx)
integration_id, table_id = response.url.strip("/").split("/")[-2:]

GET /xx/xx/schema