navan-core-workflow-a

# Navan — Travel Booking & Management ## Overview This skill provides the complete travel booking workflow through the Navan REST API. Navan has no public SDK — all access is via raw HTTP calls using OAuth 2.0 bearer tokens. This skill covers trip retrieval for both user and admin scopes, itinerary PDF downloads, invoice access, and trip filtering by date range and status. Every booking is keyed by a UUID primary key that must be tracked for deduplication and updates. ## Prerequisites - Navan account with API credentials (client_id + client_secret) - Credentials created in Admin > Travel admin > Settings > Integrations > Navan API Credentials - OAuth 2.0 token obtained via POST `/ta-auth/oauth/token` (see `navan-install-auth`) - Node.js 18+ with `node-fetch` or Python 3.8+ with `requests` - Environment variables: `NAVAN_CLIENT_ID`, `NAVAN_CLIENT_SECRET`, `NAVAN_BASE_URL` - `NAVAN_BASE_URL` should be set to `https://api.navan.com` ## Instructions ### Step 1: Authenticate and Obtain Bearer Token ```typescript const tokenRes = await fetch(`${process.env.NAVAN_BASE_URL}/ta-auth/oauth/token`, { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'client_credentials', client_id: process.env.NAVAN_CLIENT_ID!, client_secret: process.env.NAVAN_CLIENT_SECRET!, }), }); const { access_token } = await tokenRes.json(); const headers = { Authorization: `Bearer ${access_token}` }; ``` ### Step 2...