Skill UI

This comprehensive guide establishes a structured local development environment for integrating with the Navan API. Since Navan does not provide a sandbox, this workflow is crucial for minimizing calls to the production API. It implements token caching to persist access tokens, detailed request logging for debugging, and mock fixtures to allow for reliable, safe offline testing during the development cycle.

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.

Build a robust, typed API wrapper for Navan's REST endpoints, compensating for the lack of an official SDK. This pattern provides automated OAuth 2.0 token lifecycle management, built-in retry logic (for rate limiting and service downtime), and structured error handling, ensuring reliable, type-safe API interactions in production environments.

A comprehensive guide to securing Navan integrations and API access. This skill covers OAuth 2.0 best practices, secure credential storage, automated credential rotation, configuring Single Sign-On (SSO) via SAML/OpenID Connect, and implementing automated user lifecycle management using SCIM provisioning. Essential for hardening enterprise-level integrations.

A guide to building resilient software integrations when dealing with external APIs that lack formal versioning, changelogs, or guaranteed backward compatibility. Learn defensive coding patterns, implementing schema drift detection via CLI tools (curl, jq), using fallback field names, and executing gradual feature flag rollouts to maintain production stability.

This skill provides a comprehensive framework for setting up and managing real-time webhooks from the Navan platform. It covers registering callback URLs, verifying payload signatures using HMAC-SHA256, and implementing idempotent event processing. It routes and handles key events related to the booking lifecycle, expense workflow, and travel disruptions, enabling seamless integration with internal systems.

A comprehensive guide for performing end-to-end (E2E) and integration testing on the Nexu → OpenClaw gateway stack. It details the architectural constraints and viable testing methods, emphasizing the use of Vitest for reliable internal function testing (e.g., skill snapshotting, session store logic). Use this when verifying core gateway fixes, testing skill loading after restarts, or simulating complex operational scenarios.

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.