navan-deploy-integration

# Navan Deploy Integration ## Overview Navan connects to enterprise systems through multiple integration methods: direct REST API with OAuth 2.0, SCIM for user provisioning, SFTP for batch file exchange, SAML/OIDC for SSO, and webhooks for real-time events. There is no SDK — all integrations use Navan's REST endpoints or admin console configuration. This skill provides deployment checklists for the three most common integration categories: ERP expense sync, HRIS user provisioning, and identity provider SSO. ## Prerequisites - **Navan Admin** account with integration management permissions - **OAuth 2.0 credentials** — `client_id` and `client_secret` from Admin > API Settings - **Target system admin access** — NetSuite/Sage Intacct/Xero admin, Workday/BambooHR admin, or Okta/Azure AD admin - API base URL: `https://api.navan.com/v1` ## Instructions ### Category A — ERP Expense Sync (NetSuite, Sage Intacct, Xero, QuickBooks) **Deployment Checklist:** 1. **Create OAuth credentials** in Navan Admin > API Settings 2. **Configure GL code mappings** — Map Navan expense categories to your chart of accounts 3. **Set cost center mappings** — Align Navan departments with ERP cost centers 4. **Enable expense export** via REST API: ```bash # Fetch approved expenses ready for ERP sync curl -s -X GET "https://api.navan.com/v1/expenses?status=approved&limit=50" \ -H "Authorization: Bearer ${ACCESS_TOKEN}" \ -H "Content-Type: application/json" # Response includes fields for ERP m...