# POST /v1/sites/{id}/zones

Create a zone

Create an ad zone under a site. Requires scope `publisher:write` (API key or web session); not available in view-as. Rate limit tier: `write`.

- Required scope: `publisher:write`
- Rate limit: `write` — 20 requests per 60-second window per API key or web session

## Parameters

| Name | In | Type | Required |
|---|---|---|---|
| `id` | path | integer | yes |

## Request body

```
{ category?: "mainstream" | "adult"; direct_url_enabled?: boolean; freq?: { cap_count?: integer; cap_window_s?: integer; delay_s?: integer; min_interval_s?: integer; per_page?: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count?: integer; freq_cap_hours?: integer; name: string }
```

## Response

```
{ adblock_rate: number | null; category: "mainstream" | "adult"; category_source: "site" | "zone"; created_at: string; direct_url_enabled: boolean; freq: { cap_count: integer; cap_window_s: integer; delay_s: integer; min_interval_s: integer; per_page: integer | null; preset: "light" | "balanced" | "strong" | "per_page" | "custom"; repeat_after_s?: 0 | integer }; freq_cap_count: integer; freq_cap_hours: integer; id: integer; last_load_at: string | null; last_request_at: string | null; loads_24h: integer; name: string; requests_24h: integer; site_domain: string; site_id: integer; status: "active" | "paused"; tag_state: "never" | "stale" | "live"; via: "tag" | "smart_link" | "both" | null }
```

## Errors

Rate-limited routes return `RateLimit-Limit`, `RateLimit-Remaining` and `RateLimit-Reset` (seconds until the window ends); a 429 also carries `Retry-After`. The headers may be absent while the limiter is temporarily unavailable (requests are then let through).

| Status | Meaning |
|---|---|
| 401 | Missing, invalid or revoked API key. |
| 403 | The key lacks the required scope, or the operation is not allowed for this actor. |
| 429 | Rate limit exceeded; wait `Retry-After` seconds. |
| 400 | Default Response |
| 404 | Default Response |
| 409 | Default Response |

HTML documentation: https://agimone.com/en/developers/api/#create-zone
API 2026-10
