Обновление Notion API

Создавать страницы через API теперь можно с использованием шаблонов. Возможности интеграций расширяются.


⚡️ Для чего

Сценариев использования может быть множество. Первое, что пришло на ум:

🔘 Во внешней CRM-системе зарегистрирован новый лид➡️ в Notion автоматически создаётся новая задача по шаблону.

🔘 Период завершился➡️из внешнего приложения в Notion автоматически подтягиваются данные и формируется отчёт по шаблону.

🔘Во внешней HR-системе добавляется новый сотрудник➡️в Notion автоматически создается персональная страница онбординга по шаблону.


❓ Как это работает

Для создания страницы с помощью шаблона сначала нужно получить ID шаблона – либо через эндпоинт List data source templates, либо прямо из URL шаблона в Notion. Затем нужно добавить в тело запроса данные по шаблону.

Для шаблона по умолчанию:
"template": {
"type": "default"
}

Для выбранного шаблона:
"template": {
"type": "template_id",
"template_id": ""
}

Важно: содержимое (children) страницы при этом не передаётся – шаблон сам заполняет структуру. После запроса API возвращает объект страницы, но шаблон применяется асинхронно, поэтому данные появляются не сразу. Чтобы отследить момент готовности, имеет смысл использовать вебхук.


↪️ Подробнее

Больше информации об использовании шаблонов при создании страниц через API вы можете получить в официальном справочнике:
➖ List data source templates (эндпоинт);
➖ Creating pages from templates.


#notion #ношуен #ноушн #автоматизация #api