canonical: https://jentic.com/apis/gringofunnels.com/gringofunnels

# Gringo Funnels API

The Gringo Funnels API publishes tenant-scoped Sites that organize one hostname namespace with mounted funnels, listicles, quizzes, and pages. It connects custom domains through Cloudflare for SaaS and rechecks their DNS and TLS state, declares immutable deployment bundles, uploads predeclared files with exact length and checksum, and runs quality gates before publishing. It also captures and lists leads for the published funnels.

## For AI agents

Lets an AI agent publish Sites, mount funnels and pages, connect custom domains, deploy bundles, and capture leads.

## Scope

Does not handle email sending, payments, or ad buying. Use for publishing funnels, sites, and pages and capturing leads only.

## Capabilities

- Create publishing Sites and mount funnels, listicles, quizzes, or pages
- Connect custom domains and recheck their DNS and TLS state
- Declare an immutable deployment bundle and upload its predeclared files
- Run quality gates and publish a funnel bundle
- Capture and list leads for a funnel
- Reorder or unmount funnels on a Site

## Use cases

### Agent-published funnels

An AI agent can stand up a marketing funnel through Gringo Funnels by creating a Site, mounting a funnel, connecting a custom domain, and publishing a deployment bundle once its quality gates pass. Each deployment is an immutable bundle with predeclared files, so publishing is reproducible. Connected through Jentic, the agent calls only the site and deployment operations it needs.

Example prompt: Create a Site, mount a funnel, connect a custom domain, and publish a deployment bundle after its quality gates pass

### Custom domain onboarding

Publishers need customer-owned domains live with valid TLS. Gringo Funnels connects an external hostname through Cloudflare for SaaS, starts a one-time hostname claim, and rechecks DNS ownership and certificate state. An agent can drive the claim and poll the recheck until the domain is verified.

Example prompt: Start a custom hostname claim for a Site and recheck its DNS and TLS state until it is verified

### Lead capture

Funnels exist to collect leads, and those leads need to flow into downstream systems. Gringo Funnels captures a real lead and lists the leads collected, so an agent can pull new leads and forward them to a CRM or email tool. This keeps the funnel's output moving without manual export.

Example prompt: Capture a new lead from a funnel and list the leads collected since the last run

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/sites` | Create an empty publishing Site |
| POST | `/sites/{siteId}/mounts` | Mount a funnel, listicle, quiz, or page |
| POST | `/sites/{siteId}/domains` | Start a custom hostname claim for a Site |
| POST | `/funnels/{funnelId}/deployments` | Declare an immutable bundle inventory |
| POST | `/funnels/{funnelId}/deployments/{deploymentId}/complete` | Run quality gates and publish the bundle |
| POST | `/leads` | Create a real lead |
| GET | `/leads` | List leads |

## Key resources

- **Sites** — Create and manage publishing Sites and their mounted content
- **Mounts** — Mount, reorder, and unmount funnels, listicles, quizzes, and pages
- **Domains** — Connect custom domains and recheck DNS and TLS state
- **Deployments** — Declare immutable bundles, upload files, and publish
- **Leads** — Capture and list leads for a funnel

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 66 / 100
- **Maturity:** AI-Aware
- **Dimensions:**
  - Foundational Compliance: 87 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 49 / 100
  - Agent Usability: 94 / 100
  - Security: 60 / 100
  - AI Discoverability: 71 / 100
- **View full report:** https://jentic.com/apis/gringofunnels.com/gringofunnels/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring Gringo Funnels by hand means handling its Bearer API key, the Cloudflare for SaaS domain claims, and the predeclared-file length and checksum rules on each deployment yourself. Through Jentic you install once, import Gringo Funnels from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Gringo Funnels puts the site id in the URL path (`/sites/{siteId}/...`), so a rule can pin your agent to one Site and its mount and domain operations. You choose the operations it may call, so Site deletion is not included unless you add it.
- **Credential handling:** Your Gringo Funnels key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'publish a funnel' or 'connect a custom domain', and Jentic returns the matching Gringo Funnels operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **ClickFunnels API** — A hosted funnel builder versus Gringo Funnels' code-managed deployments.
- **Elite Funnels Website API** — Another funnel and website publishing API versus Gringo Funnels' Site model.
- **Prismic Content API** — A headless CMS to supply content for the pages Gringo Funnels publishes.

## FAQ

### What authentication does the Gringo Funnels API use?

Gringo Funnels authenticates with a Bearer API key sent in the Authorization header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at execution time, so it never enters the agent's context.

### Can I connect a custom domain with the Gringo Funnels API?

Yes. The domain operations start a custom hostname claim through Cloudflare for SaaS and recheck DNS ownership and certificate state, for both Sites and legacy funnel domains. You can list the current domains and their DNS and TLS status for a Site.

### What are the rate limits for the Gringo Funnels API?

The OpenAPI spec does not specify rate limits, and deployment uploads are bounded instead by predeclared file length and checksum. Check https://gringofunnels.com for current limits.

### How do I publish a funnel with the Gringo Funnels API through Jentic?

Search Jentic for 'publish a funnel deployment' and it returns the Gringo Funnels deployment operations with their input schemas, so your agent declares the bundle, uploads files, and runs the completion gate. Install Jentic One with `curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh`, import Gringo Funnels from the API Directory, and store your key once. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Can I limit what my agent is allowed to do with Gringo Funnels?

Yes. Scope the agent to one site: Gringo Funnels puts the site id in the URL path (`/sites/{siteId}/...`), so a rule can let the agent mount funnels and manage domains for that site and touch no other, and every call it makes is logged.

### Is there a Gringo Funnels MCP server?

You don't need an MCP server to connect your agent to Gringo Funnels. Jentic connects it directly from the API Directory: import it, store your credential once, and your agent discovers and calls the operations it needs on demand.