For Agents
Trigger AI voice calls, manage agents, contacts, and contact lists, and embed call widgets through the Nedzo communications platform.
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Nedzo 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.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# 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 Nedzo API.
Trigger an AI voice call from a GHL workflow via /v1/ghl/call
Create, list, and update AI agents under /v1/agents
Manage workspaces, contacts, and contact lists across /v1/workspaces and related endpoints
Upsert and delete contacts from GoHighLevel through /v1/ghl/contact
GET STARTED
Use for: I need to trigger an AI voice call from a workflow, Create a new AI voice agent in a workspace, List all agents available for a GHL workflow dropdown, Upsert a contact into a Nedzo workspace
Not supported: Does not host SIP infrastructure, send SMS, or process payments — use for AI voice agent and contact orchestration only.
Jentic publishes the only available OpenAPI specification for Nedzo API, keeping it validated and agent-ready. The Nedzo API is the programmatic surface of the Nedzo AI voice and communications platform, exposing 345 endpoints across workspaces, AI voice agents, contacts, contact lists, calls, templates, embeddable widgets, branding, and a GoHighLevel workflow integration. It supports a bearer API key for tenant access, an internal X-Service-Key for service-to-service calls, and a Supabase JWT scheme for dashboard users. The base URL is https://api.nedzo.ai and the API is structured around a /v1 namespace with public widget endpoints under /public.
Render embeddable call widgets via /public/widget/{id}/config and record impressions
Retrieve domain-scoped branding through /public/branding
Patterns agents use Nedzo API for, with concrete tasks.
★ Outbound AI Voice Campaign
A sales team triggers AI voice calls to a list of contacts using Nedzo's pre-trained agents. The team uploads or syncs the contact list, configures the agent's script and voice, then calls /v1/ghl/call from a GoHighLevel workflow or directly from a custom backend. Nedzo handles the call placement, the AI conversation, and returns the recording and outcome to the workspace.
POST /v1/ghl/call with the agent id, target phone number, and contact metadata to place an AI voice call.
Embedded Call Widget on a Marketing Site
A marketing site embeds a Nedzo call widget so visitors can speak with an AI sales agent without leaving the page. The widget pulls its theme and agent assignment from /public/widget/{id}/config, records each impression via /public/widget/{id}/impression, and uses /public/branding to render the correct logo and colors based on the host domain.
GET /public/widget/{id}/config for the embedded widget and render the agent UI with the returned theme.
Multi-Tenant Workspace Provisioning
An agency provisions a Nedzo workspace per client, configures agents and contacts, and rotates API keys via /v1/workspaces and the agent endpoints. Tenants are isolated by workspace id, and the bearer API key scopes calls to the owning tenant. The provisioning workflow takes minutes per client once the agent templates are defined.
POST /v1/workspaces with the new client name, then POST /v1/agents with the agent template configured for that workspace.
Agent-Driven Voice Outreach
An AI agent in an outbound workflow uses Jentic to discover Nedzo operations, place calls, and reconcile call outcomes back to the contact record without hard-coding any of Nedzo's 345 endpoints. The agent searches for the right operation, loads the schema, and submits the call request while Jentic handles the bearer key.
Search Jentic for 'place an AI voice call', load the schema for /v1/ghl/call, and execute it with the agent id and target phone number.
345 endpoints — jentic publishes the only available openapi specification for nedzo api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/v1/ghl/call
Trigger an AI voice call from a GHL workflow
/v1/ghl/agents
List agents for a GHL workflow
/v1/ghl/contact
Upsert a contact from GHL
/v1/workspaces
List workspaces
/v1/agents
Create an AI voice agent
/public/widget/{id}/config
Get embedded widget configuration
/public/widget/{id}/impression
Record a widget impression
/public/branding
Get domain-scoped branding
/v1/ghl/call
Trigger an AI voice call from a GHL workflow
/v1/ghl/agents
List agents for a GHL workflow
/v1/ghl/contact
Upsert a contact from GHL
/v1/workspaces
List workspaces
/v1/agents
Create an AI voice agent
Three things that make agents converge on Jentic-routed access.
Credential isolation
Nedzo bearer API keys, X-Service-Key values, and Supabase JWTs are stored encrypted in the Jentic vault. Agents receive scoped access at execution time so the raw API key never enters agent context.
Intent-based discovery
Agents search by intent such as 'place an AI voice call' and Jentic returns the matching Nedzo operation with its request schema, removing the need to navigate 345 endpoints by hand.
Time to first call
Direct Nedzo integration: 1-3 days for auth wiring, webhook handling, and call-outcome reconciliation. Through Jentic: under an hour to place a call and read its outcome with managed credentials.
Alternatives and complements available in the Jentic catalogue.
Specific to using Nedzo API through Jentic.
Why is there no official OpenAPI spec for Nedzo API?
Nedzo publishes its API as developer documentation rather than a stable OpenAPI file. Jentic generates and maintains this spec so that AI agents and developers can call Nedzo API via structured tooling. It is validated against the live api.nedzo.ai endpoints and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Nedzo API use?
Most /v1 endpoints accept a bearerAuth API key obtained from the Nedzo dashboard, sent as Authorization: Bearer <key>. Internal service-to-service calls use the X-Service-Key header with IP allowlisting, and dashboard-user calls use a Supabase JWT in Authorization: Bearer <jwt>. Through Jentic the API key is stored encrypted in the vault.
Can I trigger an AI voice call with the Nedzo API?
Yes. POST /v1/ghl/call with the agent id and target phone number plus contact metadata. The endpoint queues the call on the Nedzo platform, returns a call id, and emits webhook events with the recording and outcome when the call completes.
What are the rate limits for the Nedzo API?
Nedzo does not publish numeric per-endpoint rate limits in the OpenAPI document; outbound call concurrency is governed by the workspace's plan and carrier capacity. Expect 429 responses on bursts and back off; contact Nedzo support to lift call concurrency for production.
How do I create an AI voice agent through Jentic?
Run pip install jentic, then search for 'create a Nedzo voice agent', load the schema for POST /v1/agents, and execute it with the workspace id and the agent script and voice configuration. Jentic returns the agent id ready for use in /v1/ghl/call.
Does the Nedzo API host the carrier infrastructure?
No. Nedzo orchestrates the AI conversation and call placement on top of underlying telephony providers. The API exposes call triggering and outcome retrieval, not low-level SIP or carrier configuration.
/public/widget/{id}/config
Get embedded widget configuration
/public/widget/{id}/impression
Record a widget impression
/public/branding
Get domain-scoped branding