> ## Documentation Index
> Fetch the complete documentation index at: https://docs.marro.si/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> How to connect to and use Marro.

Marro's API lets your own server read and write your organization's leads: a website form that sends enquiries, a sync into a spreadsheet or data warehouse, an ad platform that pushes leads.

Server-to-server access to one organization’s data in Marro. Each key belongs to an organization and can use only the scopes it was given for modules the organization subscribes to. Keys go only in the Authorization header, over HTTPS, from a server: never in browser code or a URL. A key that was ever sent over plain HTTP or in a URL must be treated as leaked: revoke it and create a new one. The API sends no CORS headers.

Every response carries `X-Request-Id`, to quote to support. Once the key is checked, responses also carry `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window resets) for whichever limit is closer to running out. An address that is not an endpoint answers 404 `NOT_FOUND` in the same error shape.

Base URL:

```text theme={null}
https://app.marro.si/api/v1
```

The full specification is an OpenAPI 3.1.0 document at [https://app.marro.si/api/v1/openapi.json](https://app.marro.si/api/v1/openapi.json). Import it into Postman or a client generator.

### Leads

| Endpoint | Method | Path |
| - | - | - |
| [List leads](/api-reference/leads/list-leads) | GET | `/api/v1/leads` |
| [Create a lead](/api-reference/leads/create-lead) | POST | `/api/v1/leads` |
| [Capture a lead](/api-reference/leads/capture-lead) | POST | `/api/v1/leads/capture` |
| [Get a lead](/api-reference/leads/get-lead) | GET | `/api/v1/leads/{leadId}` |
| [Update a lead](/api-reference/leads/update-lead) | PATCH | `/api/v1/leads/{leadId}` |
| [Add a note](/api-reference/leads/add-note) | POST | `/api/v1/leads/{leadId}/notes` |

### Reference

How this organization is set up: fields, stages, sources and people.

| Endpoint | Method | Path |
| - | - | - |
| [List lead fields](/api-reference/reference/list-fields) | GET | `/api/v1/lead-fields` |
| [List stages](/api-reference/reference/list-stages) | GET | `/api/v1/lead-stages` |
| [List pipelines](/api-reference/reference/list-pipelines) | GET | `/api/v1/pipelines` |
| [List sources](/api-reference/reference/list-sources) | GET | `/api/v1/lead-sources` |
| [List people](/api-reference/reference/list-users) | GET | `/api/v1/users` |

## Next

* [Getting started](/getting-started): create a key and make your first request.
* [Connect a website](/guides/connect-a-website): send your website's enquiries into Marro.
* [Authentication](/authentication), [Keys and scopes](/keys-and-scopes), [Errors](/errors), [Rate limits](/rate-limits), [Filtering leads](/guides/filtering).
* [API reference](/api-reference/leads/list-leads): every endpoint, with a playground.