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

# Cometly API

> Use the Cometly REST API to send conversion events and manage contacts, companies and events. Start with the base URL, authentication and endpoints.

## Overview

The Cometly API provides a RESTful interface to interact with your Cometly account programmatically. Use our API to send conversion events, manage tracking data, and integrate Cometly with your applications.

### Base URL

```text theme={null}
https://app.cometly.com/public-api/v1
```

## Start here

* [Authentication](https://docs.cometly.com/introduction/authentication.md): create an API key and send it with each request.
* [Rate limiting](https://docs.cometly.com/introduction/rate-limiting.md): the limits on API requests and how to handle a 429 response.
* [Status codes](https://docs.cometly.com/introduction/status-codes.md): the response codes the API returns and what each means.
* [Ways to send data to Cometly](https://docs.cometly.com/concepts/sending-data-to-cometly.md): when to use the API, webhooks or an integration.
* [Exports vs pagination](https://docs.cometly.com/concepts/exports-vs-pagination.md): how to choose between paging through results and an export.

## What you can do with the API

* **Events:** [create an event](https://docs.cometly.com/api-reference/endpoint/create-event.md), [list events](https://docs.cometly.com/api-reference/endpoint/list-events.md), [update an event](https://docs.cometly.com/api-reference/endpoint/update-event.md) or [delete an event](https://docs.cometly.com/api-reference/endpoint/delete-event.md).
* **Contacts:** [create a contact](https://docs.cometly.com/api-reference/endpoint/create-contact.md), [list contacts](https://docs.cometly.com/api-reference/endpoint/list-contacts.md) or [look one up by email](https://docs.cometly.com/api-reference/endpoint/get-contact-by-email.md).
* **Companies:** [list companies](https://docs.cometly.com/api-reference/endpoint/list-companies.md), [update a company](https://docs.cometly.com/api-reference/endpoint/update-company.md) and [attach a contact to a company](https://docs.cometly.com/api-reference/endpoint/attach-contact-company.md).
* **Bulk data:** send large result sets to your own storage with the [data warehouse exports](https://docs.cometly.com/data-warehouse/overview.md).
* **AI clients:** connect Claude, ChatGPT, Cursor and other clients with the [Cometly MCP server](https://docs.cometly.com/mcp/overview.md).

New endpoints and changes are listed in the [changelog](https://docs.cometly.com/changelog.md).

## Support

Need help with the API? Check out our resources:

> [card] [Set up Cometly](https://docs.cometly.com/getting-started/setup.md)
>
> Set up tracking, events and the Conversion API in the app.

> [card] [Help and support](https://docs.cometly.com/support/contact.md)
>
> How to reach the Cometly team.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.