navan-hello-world

Featured

Make your first Navan API call to retrieve trip and user data. Use when verifying a new Navan integration works end-to-end after auth setup. Trigger with "navan hello world", "navan example", "test navan api", "first navan call".

AI & Automation 2,926 stars 433 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Navan Hello World ## Overview Execute a first API call against the Navan REST API to retrieve trip data. All examples use raw REST calls — Navan has **no public SDK**. **Purpose:** Confirm end-to-end integration by retrieving real trip data and parsing `uuid` primary keys. ## Prerequisites - Completed `navan-install-auth` with working OAuth 2.0 credentials - `.env` file with `NAVAN_CLIENT_ID`, `NAVAN_CLIENT_SECRET`, and `NAVAN_BASE_URL` - Node.js 18+ (for TypeScript) or Python 3.8+ (for Python) - At least one trip or user in your Navan organization ## Instructions ### Step 1: Acquire a Bearer Token Reuse the token exchange from `navan-install-auth`: ```typescript import 'dotenv/config'; async function getNavanToken(): Promise<string> { const response = 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!, }), }); if (!response.ok) throw new Error(`Auth failed: ${response.status}`); const data = await response.json(); return data.access_token; } ``` ### Step 2: Retrieve Bookings (TypeScript) Call `GET /v1/bookings` to fetch booking records (paginated with `page` + `size`): ```typescript interface NavanBooking { uuid: string; // Primary key for all booking records ...

Details

Author
jeremylongshore
Repository
jeremylongshore/claude-code-plugins-plus-skills
Created
1 years ago
Last Updated
yesterday
Language
Python
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category