For Agents
Send a single Google review invitation via the one POST endpoint exposed by the goodreviews.io campaign API.
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the GoodReviews API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with GoodReviews API.
Send one Google review invitation against a configured campaign
Wire a review request into a Zapier or Make automation
Pass campaign ID and customer contact details into a single POST
Authenticate every call with one X-APIKEY token
GET STARTED
Use for: Send a Google review invitation to a customer using GoodReviews, I want to trigger a review campaign invitation after a successful service call, Fire a single review request into a Zapier flow, Check that an X-APIKEY works against the goodreviews.io campaign endpoint
Not supported: Does not handle review monitoring, automated review responses, sentiment analysis, or non-Google review platforms — use for sending a single Google review invitation tied to a configured GoodReviews campaign only.
Jentic publishes the only available OpenAPI specification for GoodReviews API, keeping it validated and agent-ready. The GoodReviews API exposes a single endpoint, POST /api/zapier/campaign/single, that sends a Google review invitation to one customer in a configured campaign. It is the integration point for Zapier and similar tools, with an X-APIKEY header and a payload that supplies the campaign ID and the customer's contact details. Although hosted on api.goodreviews.com, this surface is documented at the goodreviews.io domain.
Trigger an invitation from any system that can call HTTPS
Patterns agents use GoodReviews API for, with concrete tasks.
★ Zapier-Wired Review Requests
Small businesses on goodreviews.io fire one review invitation per customer transaction by mapping a Zapier trigger to POST /api/zapier/campaign/single. The pattern fits e-commerce checkout, scheduling tools, and CRMs equally and requires no server code.
Map a Shopify 'order fulfilled' Zap trigger to POST /api/zapier/campaign/single with campaign id cmp_42 and the customer's email.
Programmatic Single-Customer Send
Backend services that want to bypass Zapier call the same endpoint directly with the X-APIKEY header. Because there is only one operation, integration is short — handle the auth header, post the JSON, and check the response code.
POST a campaign invitation for campaign cmp_renewals to the customer who renewed their subscription this morning.
AI Agent Review Step via Jentic
An AI agent that already coordinates customer follow-up sequences adds GoodReviews as one more step through Jentic. Because the spec is jentic-generated, the agent's MCP tool catalog has a single, validated GoodReviews operation it can call without docs.
After a positive support resolution, send a GoodReviews invitation for campaign cmp_csat to the customer's email.
1 endpoints — jentic publishes the only available openapi specification for goodreviews api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/api/zapier/campaign/single
Send a single campaign invitation
/api/zapier/campaign/single
Send a single campaign invitation
Three things that make agents converge on Jentic-routed access.
Credential isolation
GoodReviews X-APIKEY values are stored encrypted in the Jentic vault (MAXsystem) and scoped to one account. Agents receive a short-lived execution handle, so the raw key never enters the model context or logs.
Intent-based discovery
Agents search Jentic by intent (e.g. 'send a google review invitation') and Jentic returns the GoodReviews POST /api/zapier/campaign/single operation with its input schema.
Time to first call
Direct GoodReviews integration: a few hours of HTTP plumbing. Through Jentic: under 10 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
Specific to using GoodReviews API through Jentic.
Why is there no official OpenAPI spec for GoodReviews API?
GoodReviews does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call GoodReviews API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the GoodReviews API use?
The API uses an X-APIKEY header (apiKey scheme) issued per GoodReviews account. Through Jentic the key is stored encrypted in the vault and scoped to that account, so the raw key never enters the agent's context.
Can I send a review invitation with one call to the goodreviews.io API?
Yes. POST /api/zapier/campaign/single accepts the campaign ID and customer contact details, and GoodReviews handles the rest of the delivery. The base URL is api.goodreviews.com even though the documentation lives under goodreviews.io.
What are the rate limits for the GoodReviews API?
GoodReviews applies per-account rate limits sized for Zapier-style traffic. The OpenAPI spec does not encode exact numbers, so check the GoodReviews dashboard before running large historical sends — bulk runs should use a queued automation rather than a tight loop.
How do I trigger an invitation through Jentic?
Search Jentic for 'send a goodreviews invitation', load the schema for POST /api/zapier/campaign/single, and execute with the campaign ID and customer's email. Jentic injects the X-APIKEY at execution so the agent only handles the campaign and contact fields.
Does this API support replying to existing reviews?
No. The single endpoint only sends invitations. For monitoring and responding to reviews, pair with a review-management platform such as Reply Reviews or use the Google Business Profile API directly.