Skill UI

This skill provides a comprehensive framework for setting up robust observability for Navan API integrations in production environments. It guides users through implementing structured logging, tracking request latency, classifying various errors (auth, rate limit, server), and monitoring the OAuth token refresh lifecycle. Includes practical steps and YAML examples for configuring alerts and building dashboards in platforms like Datadog, CloudWatch, or Prometheus/Grafana.

This skill provides advanced architectural patterns for optimizing high-volume integrations with the Navan API. It addresses common bottlenecks like rate limiting, sequential calls, and naive pagination by implementing robust solutions such as data-type-specific response caching, controlled parallel fetching with concurrency throttling, efficient cursor-based pagination, and HTTP connection reuse. Use this when building scalable, reliable, and high-throughput systems.

A comprehensive checklist for validating the operational readiness of any Navan API integration before deployment to a live production environment. This guide covers critical areas including credential security (rotation, secret management), robust error handling, rate limit strategies, Single Sign-On (SSO) setup, data synchronization, and compliance auditing (PCI DSS, GDPR). Use this when ensuring mission-critical API stability.

This skill implements resilient API interaction patterns for external services. It uses adaptive rate-limiting techniques, including exponential backoff and jitter, to gracefully handle HTTP 429 errors, adapting to undocumented server limits. Furthermore, it provides a dedicated request queue mechanism to manage concurrency, ensuring reliable execution of large-scale, bulk data operations without triggering service throttling.

Use this guide when designing a robust, production-grade integration with the Navan API. It details a multi-layered architectural blueprint, including an API Gateway for rate limiting and circuit breaking, a centralized OAuth Token Management Service, secure data synchronization pipelines, and comprehensive monitoring stacks. Ideal for complex enterprise systems requiring reliable connectivity to travel and expense data.

Provides advanced debugging techniques for Notion API issues that standard troubleshooting cannot resolve. It covers response ID inspection, tracing complex permission chains, detecting property type mismatches, managing pagination edge cases, and resolving block nesting limits across Notion databases and pages. Essential for robust integration development.

A comprehensive guide detailing five validated architecture patterns for utilizing Notion as a powerful backend database. Use cases include: Headless CMS for blogging, task tracking for project management, building knowledge bases (wikis), handling form submissions, and serving as a data pipeline source. Includes schema design and code examples using TypeScript and Python.

This guide provides a comprehensive reference for diagnosing and fixing common Notion API errors. It covers critical HTTP statuses and specific error codes (such as 401 Unauthorized, 403 Restricted Resource, 404 Object Not Found, 400 Validation Error, and 429 Rate Limited). Use it when debugging failed Notion integrations, managing permissions, or resolving data structure issues for reliable development.

Provides comprehensive programmatic access to Notion, allowing users to create, update, archive, and compose rich content blocks within pages and databases. This skill covers the full page lifecycle—from initial creation with structured properties to appending complex blocks (headings, lists, toggles, code) and managing status updates. It is essential for building automated knowledge bases, automating content workflows, and programmatically managing enterprise information systems using the Notion API.

This guide provides three fundamental examples for integrating with the Notion API. It demonstrates how to search for existing pages, create new content within a database, and retrieve the newly created page's metadata. Ideal for developers starting a new Notion integration or implementing basic automated workflows.

This guide provides a comprehensive walkthrough for installing and configuring the Notion API SDK in both Node.js and Python environments. It covers creating internal integrations, securely setting environment variables for the API token, and verifying connectivity. Necessary for any developer building applications that interact with Notion workspaces and databases.

Provides advanced patterns for high-volume Notion API interactions. Learn how to manage rate limits (3 req/sec) using worker queues, implement parallel requests with p-queue, and efficiently paginate massive databases (100K+ records) using incremental sync and chunked processing. Essential for building robust, scalable Notion automation tools.