The Nedzo public API now covers most of the platform. You can place calls and send SMS, email, WhatsApp, Instagram and Messenger messages. You can read conversation logs and manage your contacts. Depending on your plan, you can also manage agents, phone numbers, campaigns, workflows and knowledge. Build your own app on top of Nedzo, or wire it into the CRM you already use.
Prompt versions shipped today too, so you can try a new agent prompt and switch back if it does worse.
What you can build with the conversational AI API
Until now, the API placed voice calls and handled the basics for contacts and agents. Anything past that meant logging in to the dashboard, so you couldn't automate the whole job.
Now, on plans with full API access, an agency can set up a client's agent, buy it a number, load its contacts and launch a campaign, all from code.
Send SMS, email and messages through the API
Each channel has its own endpoint under /v1/conversations: call, SMS, email, WhatsApp, Instagram and Messenger. You start a new conversation with a contact id, a phone number or an email, or you reply in an existing conversation. Each channel follows its own rules:
- WhatsApp needs a template outside the 24-hour window.
- Instagram and Messenger can only reply, within 24 hours of the contact's last message.
- Email needs a verified sending domain.
Nedzo checks Do Not Disturb before every send, on every channel. If a contact has DND on, Nedzo refuses the send. It checks opt-outs and your spend cap too. When Nedzo refuses a send, you get a clear error back, so a message never vanishes without a word.
The old /v1/call endpoint still works. It now points to /v1/conversations/call.
Read conversation logs
Before, when you placed a call through the API, the only way to learn what happened was the after-call webhook.
Now you can list your conversations and filter by type, channel, direction, agent, contact, status and date. Open one and you get the summary, the outcome, the extracted fields, and the transcript or messages. Calls come with a recording link that expires after a short time. This works on every plan.
Full contacts API on every plan
The contacts API now does everything you need, on every plan:
- Create, rename and delete tags, and add or remove them on a contact.
- Create, update and delete custom field definitions.
- Read and set Do Not Disturb.
- Import up to 10,000 contacts in one request, and get back how many Nedzo created, updated and skipped.
- Create and manage saved contact views.
- Pull up to 1,000 contacts per page, filtered by tag, name, phone, email or date.
The API can turn DND off only if the API or a person in your dashboard turned it on. If the contact asked not to be contacted, DND stays on.
If you already use the API, note one change. The contact list now returns a page with items, a total and a hasMore flag, instead of a bare list.
Manage agents, numbers and campaigns
On plans that include them, these parts of the platform are now in the API too:
- Agents: attach knowledge, and add calendar, transfer, SMS, email, WhatsApp, Slack and custom actions. Connect MCP servers, set extraction fields, duplicate an agent and test its webhook.
- Phone numbers: search, buy, update and release US and Canada local numbers, and assign one to an agent.
- Campaigns: create, start, pause and delete campaigns. See each enrolled contact's attempts and last outcome, and pull the results, like dials, pickups, bookings and minutes.
- Workflows: build, publish and turn them on or off. See past versions and roll back. Enroll up to 10,000 contacts at once, and list, cancel or retry runs.
- Knowledge: add websites, text and files to your knowledge library, and see which agents use each item.
The API returns the same errors as the dashboard, so the rules stay the same whether you click or code.
A few things still need the dashboard. You manage your team there. You connect messaging channels like Instagram there, since Meta needs a person to log in. Analytics live in the dashboard too.
Prompt versions for AI agents
You tweak your agent's prompt and it gets worse. Now you can't remember what the old one said.
With prompt versions, you switch an agent between versions of its prompt. Try a new one on real calls, and if it does worse, switch back. You don't have to dig old prompts out of a doc.
Start a free trial and build on the Nedzo API.