navan-hello-world
Create a minimal working Navan example. Use when starting a new Navan integration, testing your setup, or learning basic Navan API patterns. Trigger with phrases like "navan hello world", "navan example", "navan quick start", "simple navan code".
claude-code
Allowed Tools
ReadWriteEdit
Provided by Plugin
navan-pack
Claude Code skill pack for Navan (24 skills)
Installation
This skill is included in the navan-pack plugin:
/plugin install navan-pack@claude-code-plugins-plusClick to copy
Instructions
Navan Hello World
Overview
Minimal working example demonstrating core Navan functionality.
Prerequisites
- Completed
navan-install-authsetup - Valid API credentials configured
- Development environment ready
Instructions
Step 1: Create Entry File
Create a new file for your hello world example.
Step 2: Import and Initialize Client
import { NavanClient } from '@navan/sdk';
const client = new NavanClient({
apiKey: process.env.NAVAN_API_KEY,
});
Step 3: Make Your First API Call
async function main() {
// Your first API call here
}
main().catch(console.error);
Output
- Working code file with Navan client initialization
- Successful API response confirming connection
- Console output showing:
Success! Your Navan connection is working.
Error Handling
| Error | Cause | Solution |
|---|---|---|
| Import Error | SDK not installed | Verify with npm list or pip show |
| Auth Error | Invalid credentials | Check environment variable is set |
| Timeout | Network issues | Increase timeout or check connectivity |
| Rate Limit | Too many requests | Wait and retry with exponential backoff |
Examples
TypeScript Example
import { NavanClient } from '@navan/sdk';
const client = new NavanClient({
apiKey: process.env.NAVAN_API_KEY,
});
async function main() {
// Your first API call here
}
main().catch(console.error);
Python Example
from navan import NavanClient
client = NavanClient()
# Your first API call here
Resources
Next Steps
Proceed to navan-local-dev-loop for development workflow setup.