# Headlight

> Documentation for Headlight.

- [Welcome](https://docs.withheadlight.com/index.md): Headlight documentation
- [Quickstart](https://docs.withheadlight.com/quickstart.md): Get oriented with Headlight
- [Authentication](https://docs.withheadlight.com/authentication.md): How Headlight authenticates API and web requests
- [Quickstart](https://docs.withheadlight.com/embed/quickstart.md)
- [Schema reference](https://docs.withheadlight.com/embed/schema-reference.md)
- [Mapping guide](https://docs.withheadlight.com/embed/mapping-guide.md)
- [Postmessage protocol](https://docs.withheadlight.com/embed/postmessage-protocol.md)
- [Token minting](https://docs.withheadlight.com/embed/token-minting.md)
- [Security appendix](https://docs.withheadlight.com/embed/security-appendix.md)
- [Verification runbook](https://docs.withheadlight.com/embed/verification-runbook.md)
- [Known footguns](https://docs.withheadlight.com/embed/known-footguns.md)
- [List households](https://docs.withheadlight.com/api-reference/households/list-households.md): Returns a paginated list of households for the authenticated organization. Requires the `households:read` permission on the API key or session.
- [Create household](https://docs.withheadlight.com/api-reference/households/create-household.md): Creates a household. Requires the `households:write` permission.

## OpenAPI Specs

- [openapi](/openapi.json)