Lava CRM

First-party CRM that ships with every Lava account: contacts, accounts (companies), leads, opportunities (deals), tasks, cases, and invoices over a REST API. Best for agents that read or update the user’s own CRM, syncing contacts, logging activity, advancing deals, or creating follow-up tasks, with zero setup because Lava provisions and connects the credential automatically. Every call is scoped to the caller’s org. 15 example endpoints available through Lava’s AI Gateway. See the Lava CRM API docs for full documentation.

This is a managed Lava service — no setup required. Lava provisions and connects it for you automatically.

This is a catch-all provider — any valid URL under https://lava-crm-api.fly.dev is supported. Lava CRM REST API. Base: https://lava-crm-api.fly.dev, all paths under /api/ with a trailing slash. Auth: Bearer token (provisioned automatically by Lava; no manual key). Resources: /api/contacts/, /api/accounts/ (companies), /api/leads/, /api/opportunities/ (deals), /api/tasks/, /api/cases/, /api/invoices/. List endpoints support page and search query params; detail endpoints are /api/{resource}/{id}/. Deal pipelines with fully custom stages live under /api/deal-pipelines/: list pipelines GET /api/deal-pipelines/, create a pipeline POST /api/deal-pipelines/ {name}, board (each stage with its deals) GET /api/deal-pipelines/board/?pipeline_id=<id>, add a custom stage POST /api/deal-pipelines/<pipeline_id>/stages/ {name}, rename a stage PUT /api/deal-pipelines/stages/<stage_id>/ {name}, delete an (empty, non Won/Lost) stage DELETE /api/deal-pipelines/stages/<stage_id>/. To move a deal between stages, use PATCH /api/deal-pipelines/deals/<deal_id>/move/ {stage_id} with a stage_id from the board — NOT the fixed 6-value ‘stage’ enum on /api/opportunities/ (PROSPECTING/QUALIFICATION/PROPOSAL/NEGOTIATION/CLOSED_WON/CLOSED_LOST). That enum is legacy and only accepts those six values; custom stages (e.g. Contacted, Meeting) only exist through /api/deal-pipelines/. Moving a deal to a Won/Lost stage closes it automatically. All access is scoped to the caller token owner org. The endpoints below are curated examples.

Endpoints

List contacts. Supports page and search query params.

GET https://lava-crm-api.fly.dev/api/contacts/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/contacts/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fcontacts%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a contact. Common fields: first_name, last_name, primary_email, mobile_number.

POST https://lava-crm-api.fly.dev/api/contacts/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/contacts/', {
  body: {
"first_name": "Jane",
"last_name": "Smith",
"primary_email": "jane@example.com"
},
});

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fcontacts%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Jane","last_name":"Smith","primary_email":"jane@example.com"}'

Update a contact by id (partial update).

PATCH https://lava-crm-api.fly.dev/api/contacts/{id}/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/contacts/{id}/', { method: 'PATCH', body: {"title":"VP Sales"} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fcontacts%2F%7Bid%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"VP Sales"}'

Delete a contact by id.

DELETE https://lava-crm-api.fly.dev/api/contacts/{id}/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/contacts/{id}/', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fcontacts%2F%7Bid%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

List accounts (companies the org does business with).

GET https://lava-crm-api.fly.dev/api/accounts/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/accounts/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Faccounts%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List leads. Supports page and search query params.

GET https://lava-crm-api.fly.dev/api/leads/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/leads/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fleads%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List opportunities (deals) across the pipeline.

GET https://lava-crm-api.fly.dev/api/opportunities/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/opportunities/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fopportunities%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List tasks.

GET https://lava-crm-api.fly.dev/api/tasks/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/tasks/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Ftasks%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

List deal pipelines (a default pipeline is auto-provisioned). Each has stages with stage_type open/won/lost.

GET https://lava-crm-api.fly.dev/api/deal-pipelines/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Create a deal pipeline. Seeds default stages plus a mandatory Won and Lost stage.

POST https://lava-crm-api.fly.dev/api/deal-pipelines/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/', { body: {"name":"Enterprise"} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Enterprise"}'

Pipeline board: every stage (column) with its deals and the stage ids needed to move deals. Pass ?pipeline_id=<id> to pick a pipeline; omit for the default.

GET https://lava-crm-api.fly.dev/api/deal-pipelines/board/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/board/', { method: 'GET' });

curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2Fboard%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY"

Move a deal to a stage. Use stage_id from the board, not the opportunity ‘stage’ enum. Moving to a Won/Lost stage closes the deal. Optional above_id/below_id position it within the stage.

PATCH https://lava-crm-api.fly.dev/api/deal-pipelines/deals/{deal_id}/move/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/deals/{deal_id}/move/', { method: 'PATCH', body: {"stage_id":"{stage_id}"} });

curl -X PATCH "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2Fdeals%2F%7Bdeal_id%7D%2Fmove%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"stage_id":"{stage_id}"}'

Add a custom open stage to a pipeline (e.g. Contacted, Meeting). This is the only way custom stages exist on the backend.

POST https://lava-crm-api.fly.dev/api/deal-pipelines/{pipeline_id}/stages/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/{pipeline_id}/stages/', { body: {"name":"Contacted"} });

curl -X POST "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2F%7Bpipeline_id%7D%2Fstages%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Contacted"}'

Rename a stage by id.

PUT https://lava-crm-api.fly.dev/api/deal-pipelines/stages/{stage_id}/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/stages/{stage_id}/', { method: 'PUT', body: {"name":"Discovery"} });

curl -X PUT "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2Fstages%2F%7Bstage_id%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Discovery"}'

Delete a stage by id. Only empty open stages can be deleted; Won and Lost are required and protected.

DELETE https://lava-crm-api.fly.dev/api/deal-pipelines/stages/{stage_id}/ — Free

SDK
cURL

const data = await lava.gateway('https://lava-crm-api.fly.dev/api/deal-pipelines/stages/{stage_id}/', { method: 'DELETE' });

curl -X DELETE "https://api.lava.so/v1/forward?u=https%3A%2F%2Flava-crm-api.fly.dev%2Fapi%2Fdeal-pipelines%2Fstages%2F%7Bstage_id%7D%2F" \
  -H "Authorization: Bearer $LAVA_SECRET_KEY" \
  -H "Content-Type: application/json"

Endpoints

List contacts. Supports page and search query params.

Create a contact. Common fields: first_name, last_name, primary_email, mobile_number.

Update a contact by id (partial update).

Delete a contact by id.

List accounts (companies the org does business with).

List leads. Supports page and search query params.

List opportunities (deals) across the pipeline.

List tasks.

List deal pipelines (a default pipeline is auto-provisioned). Each has stages with stage_type open/won/lost.

Create a deal pipeline. Seeds default stages plus a mandatory Won and Lost stage.

Pipeline board: every stage (column) with its deals and the stage ids needed to move deals. Pass ?pipeline_id=<id> to pick a pipeline; omit for the default.

Move a deal to a stage. Use stage_id from the board, not the opportunity ‘stage’ enum. Moving to a Won/Lost stage closes the deal. Optional above_id/below_id position it within the stage.

Add a custom open stage to a pipeline (e.g. Contacted, Meeting). This is the only way custom stages exist on the backend.

Rename a stage by id.

Delete a stage by id. Only empty open stages can be deleted; Won and Lost are required and protected.

Next Steps

All Providers

Forward Proxy

​Endpoints

​List contacts. Supports page and search query params.

​Create a contact. Common fields: first_name, last_name, primary_email, mobile_number.

​Update a contact by id (partial update).

​Delete a contact by id.

​List accounts (companies the org does business with).

​List leads. Supports page and search query params.

​List opportunities (deals) across the pipeline.

​List tasks.

​List deal pipelines (a default pipeline is auto-provisioned). Each has stages with stage_type open/won/lost.

​Create a deal pipeline. Seeds default stages plus a mandatory Won and Lost stage.

​Pipeline board: every stage (column) with its deals and the stage ids needed to move deals. Pass ?pipeline_id=<id> to pick a pipeline; omit for the default.

​Move a deal to a stage. Use stage_id from the board, not the opportunity ‘stage’ enum. Moving to a Won/Lost stage closes the deal. Optional above_id/below_id position it within the stage.

​Add a custom open stage to a pipeline (e.g. Contacted, Meeting). This is the only way custom stages exist on the backend.

​Rename a stage by id.

​Delete a stage by id. Only empty open stages can be deleted; Won and Lost are required and protected.

​Next Steps

All Providers

Forward Proxy

Endpoints

List contacts. Supports page and search query params.

Create a contact. Common fields: first_name, last_name, primary_email, mobile_number.

Update a contact by id (partial update).

Delete a contact by id.

List accounts (companies the org does business with).

List leads. Supports page and search query params.

List opportunities (deals) across the pipeline.

List tasks.

List deal pipelines (a default pipeline is auto-provisioned). Each has stages with stage_type open/won/lost.

Create a deal pipeline. Seeds default stages plus a mandatory Won and Lost stage.

Pipeline board: every stage (column) with its deals and the stage ids needed to move deals. Pass ?pipeline_id=<id> to pick a pipeline; omit for the default.

Move a deal to a stage. Use stage_id from the board, not the opportunity ‘stage’ enum. Moving to a Won/Lost stage closes the deal. Optional above_id/below_id position it within the stage.

Add a custom open stage to a pipeline (e.g. Contacted, Meeting). This is the only way custom stages exist on the backend.

Rename a stage by id.

Delete a stage by id. Only empty open stages can be deleted; Won and Lost are required and protected.

Next Steps