Public Lead API
The Public Lead API lets external providers submit a lead (a potential order) to Navigo CRM and track its status.
Endpoints
| Method | Endpoint | Description |
|---|---|---|
POST | /api/v1/public/leads/ | Submit a new lead |
GET | /api/v1/public/leads/{external_id}/ | Get a lead's status |
Authentication
All requests are protected with a Provider API Key:
Authorization: Bearer <YOUR_API_KEY>
More: Authentication.
Lead lifecycle
Every lead moves through three main stages inside Navigo. The current stage is
returned in the state field:
LEAD ───────► QUOTE ───────► ORDER
(just created) (price quote) (order)
state | Meaning |
|---|---|
LEAD | Newly created, not yet processed |
QUOTE | Turned into a price quote |
ORDER | Turned into an order (confirmed) |
Scoping (visibility)
Each provider can only see the leads they submitted. Accessing another
provider's lead returns 403 or 404.
Idempotency
The external_id field must be unique per provider. It is an ID from your own
system and prevents duplicate leads — submitting a second time with the same
external_id returns an error.
Next steps
- Create Lead — submit a lead, all fields.
- Get Lead — get a lead's status.
- Data Models — Vehicle object, enums, state ID lookup.