navan-debug-bundle

# Navan Debug Bundle ## Overview Collect diagnostic data from Navan REST API integrations into a structured, shareable debug bundle. Navan has no SDK — all debugging uses raw HTTP requests against their OAuth 2.0 REST endpoints. ## Prerequisites - Navan API credentials: `client_id` and `client_secret` from Admin > Travel admin > Settings > Integrations - `curl` and `jq` installed locally - Credentials are viewable **only once** at creation — store them in a secret manager immediately - No sandbox environment exists; all API calls hit production ## Instructions ### Step 1 — Create Bundle Directory ```bash BUNDLE_DIR="navan-debug-$(date +%Y%m%d-%H%M%S)" mkdir -p "$BUNDLE_DIR"/{auth,api,connectivity,env} echo "Bundle initialized: $BUNDLE_DIR" ``` ### Step 2 — Capture Environment State ```bash cat > "$BUNDLE_DIR/env/config.txt" <<ENVEOF Timestamp: $(date -u +"%Y-%m-%dT%H:%M:%SZ") NAVAN_CLIENT_ID: ${NAVAN_CLIENT_ID:+SET (not empty)}${NAVAN_CLIENT_ID:-UNSET} NAVAN_CLIENT_SECRET: ${NAVAN_CLIENT_SECRET:+SET (not empty)}${NAVAN_CLIENT_SECRET:-UNSET} NAVAN_TOKEN_URL: ${NAVAN_TOKEN_URL:-https://api.navan.com/ta-auth/oauth/token} curl version: $(curl --version | head -1) jq version: $(jq --version 2>/dev/null || echo "not installed") ENVEOF ``` ### Step 3 — Test OAuth Token Acquisition ```bash curl -s -w "\n---HTTP_CODE:%{http_code}---\n" \ -X POST "https://api.navan.com/ta-auth/oauth/token" \ -H "Content-Type: application/x-www-form-urlencoded" \ -d "grant_type=client_c...