Your product, forms and internal tools know things Dialvo should act on. One API lets you trigger agents from anywhere and receive what happened, in a structured form your systems can use.

POST /v1/leadsExample
{
  "play": "speed-to-lead",
  "lead": {
    "name": "Lena Ortiz",
    "company": "Bright Smile Dental",
    "phone": "+44 131 ··· 0142",
    "consent": { "call": true, "source": "website form" }
  },
  "context": "Asked for a quote on a booking site"
}
Illustrative request. Field names may differ in the final API.

API, in 6 specifics.

  • Create leads and start plays

    Post a lead from any form, app or script and say which play to run. The speed-to-lead callback starts from one request.

  • Send product events

    Tell Dialvo that a user reached a limit, invited teammates or went quiet. Expansion and PLG plays are triggered from these.

  • Webhooks for outcomes

    Receive an event when a call ends, a reply arrives, a meeting is booked or a lead is qualified.

  • Structured results

    Outcomes arrive as clean fields (qualified or not, answers to each question, next step), with the transcript alongside.

  • Read anything back

    Fetch conversations, transcripts, recordings, sequence status and analytics for your own dashboards.

  • Manage consent and suppression

    Record opt-ins and opt-outs from your own systems, so consent captured in your app is honoured by every agent.

The API is the door for anything the built-in integrations don't cover. Most teams use it for two things: getting leads and product events in, and getting outcomes out to a data warehouse or an internal tool.

It exposes the same agents and rules as the app. A call triggered through the API still checks consent and follows your send windows.

Plays that rely on it

What you decide, and what this feature won't do.

Keys and scopes
Create keys limited to what an integration needs, such as write leads only, and revoke them at any time.
Signed webhooks
Every webhook is signed, so your server can check it came from Dialvo.
Rate limits
Requests are rate limited per key. Limits are shown in the response headers.
Plan
The API is part of Pro. The API reference is shared with teams when the API is switched on for their account.

Now open

Create your account in a couple of minutes and try Dialvo free for 7 days.

Starter is $99 a month after the free trial. Compare plans