API Documentation

Build powerful form experiences with Dialivo's REST API and React components

Authentication

All API requests require a Bearer token. Get your API key from your dashboard.

curl -H "Authorization: Bearer ff_live_1234567890abcdef" \
-H "Content-Type: application/json" \
https://api.dialivo.com/v1/forms

Get your API key: Dashboard → API Keys

Forms API

GET /v1/forms

List all forms in your account

curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.dialivo.com/v1/forms

POST /v1/forms

Create a new form

curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Contact Form",
"fields": [
{"type": "text", "name": "name", "label": "Full Name", "required": true},
{"type": "email", "name": "email", "label": "Email", "required": true},
{"type": "textarea", "name": "message", "label": "Message"}
]
}' \
https://api.dialivo.com/v1/forms

GET /v1/forms/{id}

Get a specific form

curl -H "Authorization: Bearer YOUR_API_KEY" \
https://api.dialivo.com/v1/forms/form_123

Submissions

GET /v1/forms/{id}/submissions

Get form submissions with pagination

curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.dialivo.com/v1/forms/form_123/submissions?page=1&limit=50"

POST /v1/submit/{form_id}

Submit form data (public endpoint, no auth required)

curl -X POST \
-H "Content-Type: application/json" \
-d '{
"name": "John Doe",
"email": "john@example.com",
"message": "Hello from the API!"
}' \
https://api.dialivo.com/v1/submit/form_123

AI Generation

POST /v1/ai/generate

Generate form from AI prompt

curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"prompt": "Create a customer feedback form with rating, comments, and contact info",
"style": "modern",
"include_validation": true
}' \
https://api.dialivo.com/v1/ai/generate

React Components

Embed forms directly in your React applications

Installation

npm install @dialivo/react

Basic Usage

import { DialivoEmbed } from '@dialivo/react';

function ContactPage() {
  return (
    <DialivoEmbed
      formId="form_123"
      onSubmit={(data) => console.log('Form submitted:', data)}
      onLoad={() => console.log('Form loaded')}
      style={{ width: '100%', minHeight: '400px' }}
    />
  );
}

JavaScript Embed SDK

Embed forms in any website with vanilla JavaScript

CDN Installation

<script src="https://cdn.dialivo.com/embed.js"></script>

Embed Form

<div id="dialivo-form"></div>

<script>
  Dialivo.embed({
    formId: 'form_123',
    container: '#dialivo-form',
    onSubmit: function(data) {
      console.log('Form submitted:', data);
    }
  });
</script>

Webhooks

Receive real-time notifications when forms are submitted

Configure Webhook

curl -X POST \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-app.com/webhooks/dialivo",
"events": ["form.submitted", "form.updated"],
"secret": "your_webhook_secret"
}' \
https://api.dialivo.com/v1/webhooks

Webhook Payload Example

{
  "event": "form.submitted",
  "form_id": "form_123",
  "submission_id": "sub_456",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "message": "Hello!"
  },
  "timestamp": "2025-11-15T16:30:00Z"
}

Support & Resources

Developer Support

Need help integrating Dialivo? Our developer team is here to help.

developers@dialivo.com

Status Page

Monitor API uptime and service status.

status.dialivo.com
← Back to Dialivo