---
title: "Mount a funnel, listicle, quiz, or page"
method: POST
path: "/sites/{siteId}/mounts"
---

# Mount a funnel, listicle, quiz, or page

`POST /sites/{siteId}/mounts`

## Request

- Base URL: `https://gringofunnels.com/api/v1`
- URL: `https://gringofunnels.com/api/v1/sites/{siteId}/mounts`
- Auth: HTTP bearer

Requires funnels:write. A funnel can be mounted once, and a mount path must be unique within its Site. If the Site already has any custom domain, an active custom_domains entitlement is required because this changes live hostname routing.

## Request body

- SiteMountCreate
  - `funnelId` string, uuid, required
  - `mountPath` string: Safe Site path. Platform routes such as /api and /_next are reserved.
  - `position` integer

## Response `201`

Funnel mounted

## Other responses

- `401`: Missing or invalid API key
- `402`: The workspace lacks an active entitlement for this paid capability. Agents must show this error to the owner and must not mutate DNS or retry around billing.
- `403`: The scoped credential does not grant this operation
- `404`: Site or funnel not found
- `409`: Funnel already mounted or mount path is in use
- `422`: Invalid query parameters

---

[API](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api.md) · [All operations](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gringofunnels/apis/gringo-funnels-api/revisions/b57b5e365b56?raw)