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

# Introduction

> Welcome to the oneform API documentation. Learn how to integrate forms and submissions into your applications programmatically.

<Note>
  The oneform API is designed to help developers automate form management and submission retrieval.
</Note>

Welcome to the oneform REST API. This API allows you to interact with your oneform account programmatically, enabling you to access forms, retrieve submissions, and manage webhooks from your own applications or third-party tools.

## Base URL

The oneform API is built on REST principles and enforces HTTPS for security. All API requests should be made to the following base URL:

```bash theme={null}
https://app.oneform.one/api
```

## Authentication

Authentication is required for all API requests. You must include your API key in the `Authorization` header of each request.

```bash theme={null}
Authorization: Bearer <your-api-key>
```

<CardGroup cols={1}>
  <Card title="Get your API Key" icon="key" href="/api-reference/api-keys">
    Learn how to generate and manage your API keys to authenticate your requests.
  </Card>
</CardGroup>

## Rate Limits

To ensure service stability, the API enforces rate limits on requests.

<Warning>
  All endpoints are limited to **100 requests per minute** per account.
</Warning>

If you exceed this limit, you will receive a `429 Too Many Requests` response.

## Webhooks

Avoid polling the API for new submissions. Instead, use webhooks to receive real-time notifications when a form is submitted.

<CardGroup cols={1}>
  <Card title="Set up Webhooks" icon="webhook" href="/api-reference/endpoint/webhooks">
    Configure webhooks to get instant updates and avoid hitting rate limits.
  </Card>
</CardGroup>