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

# Authentication

> Create and manage API keys

<Info>
  **Free beta.** API access is free while the API is in beta. Paid plans are coming later, and we'll give you plenty of notice before any charges begin.
</Info>

Use API keys to connect external tools and scripts to your account. Keys have access to all workspaces in your organization.

Common use cases:

* **Automation** — n8n, Make, Zapier workflows
* **CRM / GHL** — Go High Level and similar tools pushing content into Marky
* **Custom integrations** — your own scripts or internal tools

All API requests require a Bearer token in the `Authorization` header.

## Access

API keys are currently available to all plans with organization access during the free beta period. Exact packaging and pricing for API access after our preview period are not finalized.

<Note>AppSumo users follow the same rules as their equivalent paid tier.</Note>

## Create an API key

1. Open **[Organization Settings — API Keys](https://app.mymarky.ai/org/settings#api-keys)** while signed in. You are redirected to your org’s settings URL and the page scrolls to **API Keys**. (From the app: **Settings** in the left sidebar, then scroll to **API Keys**, or use that link.)
2. Click **Create API Key**
3. Give it a name (e.g., "n8n production", "Zapier")
4. Copy the key immediately. It's only shown once.

<Note>You must be an **org admin** to create API keys.</Note>

Your key looks like this:

```
mk_live_a1b2c3d4e5f6g7h8i9j0...
```

## Use your API key

Include the key as a Bearer token in every request:

```bash theme={null}
curl https://api.mymarky.ai/api/businesses/{business_id}/posts \
  -H "Authorization: Bearer mk_live_your_key_here" \
  -H "Content-Type: application/json"
```

## Key security

* Keys are hashed before storage. We cannot retrieve a lost key; generate a new one.
* Revoke compromised keys immediately in [Organization Settings — API Keys](https://app.mymarky.ai/org/settings#api-keys).
* Each org can have up to 10 active keys.
* Use separate keys for separate integrations so you can revoke individually.

## Error responses

| Status | Meaning                                          |
| ------ | ------------------------------------------------ |
| `401`  | Missing or invalid API key                       |
| `403`  | Business doesn't belong to your org              |
| `429`  | Rate limit exceeded (check `Retry-After` header) |