---
title: "Light AI API"
url: https://docs.light-ai.app/overview.md
canonical_url: https://docs.light-ai.app/overview
last_updated: 2026-10-13
summary: "Send leads into Light AI from any channel, generate lighting mockups, and sync quotes and outcomes to your CRM with a REST API and signed webhooks."
api_status: beta
related:
  - https://docs.light-ai.app/quickstart
  - https://docs.light-ai.app/authentication
  - https://docs.light-ai.app/webhooks
  - https://docs.light-ai.app/api-reference
---

# Light AI API

> Send leads into Light AI from any channel, generate lighting mockups, and sync quotes and outcomes to your CRM with a REST API and signed webhooks.

> **Beta:** The Light AI API, webhooks and MCP server are included on Pro and Enterprise. The API is still in beta: endpoints can still change, but breaking changes only ship in a new dated API version, listed in the [changelog](https://docs.light-ai.app/changelog).

Light AI is the measuring, mockup and quoting app for Christmas and permanent lighting contractors. The API connects it to the rest of a contractor's stack: ad lead forms, CRMs, field-service tools and automation platforms.

- [Quickstart](https://docs.light-ai.app/quickstart.md): First key, first lead and first webhook in five minutes.
- [Inbound leads](https://docs.light-ai.app/inbound.md): Google Ads, Meta, HighLevel, Zapier, n8n or any form, without code.
- [Webhooks](https://docs.light-ai.app/webhooks.md): Signed events for new leads, quotes, approvals and mockups.
- [Mockups](https://docs.light-ai.app/mockups.md): Generate mockups with Light AI Gen 3.0 from the contractor's credits.
- [Partners](https://docs.light-ai.app/partners.md): Serve many contractors from one partner account.
- [API reference](https://docs.light-ai.app/api-reference.md): Every endpoint, field and error, generated from OpenAPI.

## What you can build

- **Leads in.** Every estimate request lands in Light AI as a lead and a project (listed under **Quotes** in the contractor's app), deduplicated across channels ([Inbound leads](https://docs.light-ai.app/inbound)).
- **Quotes and outcomes out.** Published quotes with line items and totals, views, approvals, declines and expiries reach your CRM as [webhooks](https://docs.light-ai.app/webhooks) or through the [events feed](https://docs.light-ai.app/pagination).
- **Two-way sync.** Record approvals made in another system with `mark_approved` and write your CRM ids back as [external references](https://docs.light-ai.app/external-refs).
- **Mockups.** Generate lighting mockups for a project through the API, charged to the contractor's own credits ([Mockups](https://docs.light-ai.app/mockups)).

## Access

API access is included on **Pro** (Pro, Enterprise and Pro trials). Free and Plus have no API access: no keys, no test mode, no webhooks and no inbound sources.

There is nothing to request: every Pro and Enterprise organization can create keys in Settings → Developers.

|   |   |
| --- | --- |
| API base URL | `https://api.light-ai.app/v1` |
| Auth | `Authorization: Bearer lai_live_…` (test mode: `lai_test_…`) |
| Version | `2026-11-01` (pin with `Light-AI-Version`) |
| Format | JSON; errors are RFC 9457 problem details |
| Webhooks | Standard Webhooks signatures, retries for about 4 days, replay |
| Machine-readable | [openapi.json](https://docs.light-ai.app/openapi.json), [llms.txt](https://docs.light-ai.app/llms.txt), [llms-full.txt](https://docs.light-ai.app/llms-full.txt), `.md` for every page |

## For AI agents

Every page is available as Markdown: append `.md` to its URL (for example [/quickstart.md](https://docs.light-ai.app/quickstart.md)). [llms.txt](https://docs.light-ai.app/llms.txt) indexes every page and [llms-full.txt](https://docs.light-ai.app/llms-full.txt) holds the whole site in one file. Use **Copy page** at the top of any page to paste it into your assistant.