> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.partnerpage.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.partnerpage.io/_mcp/server.

# Authentication

Requests to the PartnerPage API carry an API key in the `Authorization` header:

```
Authorization: Token <your API key>
```

Create and copy your keys in the PartnerPage dashboard under [Settings → Developers](https://directory.partnerpage.io/developers). Endpoints that need a key refuse requests without a valid one. The public reads used to [build your own directory site](/guides/build-your-own-directory-site) need no key.

The base URL for every request is:

```
https://v1.api.partnerpage.io
```

Always use HTTPS, so your API key is encrypted on its way to us.

## Full-access and read-only keys

Your organization can have two kinds of key:

* A **full-access key** can read and change everything your organization can.
* A **read-only key** can only read. It cannot make changes, and it cannot read API keys, webhook signing secrets or webhook addresses, because those work as credentials.

Use a read-only key wherever a key only needs to read, and keep every key on your server, never in browser code.

## Rate limits

Each API key can make up to 1,000 requests per hour to each endpoint. Two endpoints allow 50 requests per hour: [Create a new partner contact request](/api-reference/contact-request/create-a-new-partner-contact-request) and [Create a new directory matchmaking request](/api-reference/matchmaking/create-a-new-directory-matchmaking-request). Over the limit, the API answers `429 Too Many Requests`. Wait and try again.