cURL
curl -sS -X POST "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups" \
-H "Authorization: Bearer $ONDIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}'const res = await fetch("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.ONDIAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}),
});
const data = await res.json();
console.log(res.status, data);import os
import requests
res = requests.request(
"POST",
"https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups",
headers={
"Authorization": f"Bearer {os.environ['ONDIAL_API_KEY']}",
},
json={
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": False,
"consent": {
"outboundCall": True,
"source": "crm",
},
},
timeout=30,
)
print(res.status_code, res.json())<?php
$ch = curl_init("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("ONDIAL_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
'channel' => 'call',
'scheduledAt' => '2026-08-12T10:00:00Z',
'force' => false,
'consent' => [
'outboundCall' => true,
'source' => 'crm',
],
]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups"))
.header("Authorization", "Bearer " + System.getenv("ONDIAL_API_KEY"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}
"""))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}using System;
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups");
request.Headers.Add("Authorization", "Bearer " + Environment.GetEnvironmentVariable("ONDIAL_API_KEY"));
request.Content = new StringContent("""
{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}
""", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}`)
req, _ := http.NewRequest("POST", "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("ONDIAL_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}{
"contactId": "<string>",
"channels": [
"<string>"
],
"scheduledAt": "2023-11-07T05:31:56Z",
"status": "<string>",
"forced": true,
"emailScheduledAt": "2023-11-07T05:31:56Z",
"whatsappScheduledAt": "2023-11-07T05:31:56Z",
"emailTemplateId": "<string>",
"emailProfileId": "<string>",
"whatsappTemplateId": "<string>",
"whatsappProfileId": "<string>"
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"error": "Not found",
"reasonCode": "not_found"
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}Schedule follow-up
Schedule a follow-up on an existing contact. Use force to overwrite.
POST
https://dashboard.ondial.ai
/
api
/
v1
/
contacts
/
{id}
/
followups
cURL
curl -sS -X POST "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups" \
-H "Authorization: Bearer $ONDIAL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}'const res = await fetch("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.ONDIAL_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}),
});
const data = await res.json();
console.log(res.status, data);import os
import requests
res = requests.request(
"POST",
"https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups",
headers={
"Authorization": f"Bearer {os.environ['ONDIAL_API_KEY']}",
},
json={
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": False,
"consent": {
"outboundCall": True,
"source": "crm",
},
},
timeout=30,
)
print(res.status_code, res.json())<?php
$ch = curl_init("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups");
curl_setopt_array($ch, [
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("ONDIAL_API_KEY"),
"Content-Type: application/json",
],
CURLOPT_POSTFIELDS => json_encode([
'channel' => 'call',
'scheduledAt' => '2026-08-12T10:00:00Z',
'force' => false,
'consent' => [
'outboundCall' => true,
'source' => 'crm',
],
]),
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $status . " " . $response;import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Main {
public static void main(String[] args) throws Exception {
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups"))
.header("Authorization", "Bearer " + System.getenv("ONDIAL_API_KEY"))
.header("Content-Type", "application/json")
.method("POST", HttpRequest.BodyPublishers.ofString("""
{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}
"""))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode() + " " + response.body());
}
}using System;
using System.Net.Http;
using System.Text;
using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups");
request.Headers.Add("Authorization", "Bearer " + Environment.GetEnvironmentVariable("ONDIAL_API_KEY"));
request.Content = new StringContent("""
{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}
""", Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode + " " + await response.Content.ReadAsStringAsync());package main
import (
"bytes"
"fmt"
"io"
"net/http"
"os"
)
func main() {
body := []byte(`{
"channel": "call",
"scheduledAt": "2026-08-12T10:00:00Z",
"force": false,
"consent": {
"outboundCall": true,
"source": "crm"
}
}`)
req, _ := http.NewRequest("POST", "https://dashboard.ondial.ai/api/v1/contacts/YOUR_ID/followups", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("ONDIAL_API_KEY"))
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(out))
}{
"contactId": "<string>",
"channels": [
"<string>"
],
"scheduledAt": "2023-11-07T05:31:56Z",
"status": "<string>",
"forced": true,
"emailScheduledAt": "2023-11-07T05:31:56Z",
"whatsappScheduledAt": "2023-11-07T05:31:56Z",
"emailTemplateId": "<string>",
"emailProfileId": "<string>",
"whatsappTemplateId": "<string>",
"whatsappProfileId": "<string>"
}{
"error": "Invalid or inactive API key",
"reasonCode": "unauthorized"
}{
"error": "Not found",
"reasonCode": "not_found"
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}{
"leadId": 177,
"error": "<string>",
"reasonCode": "<string>",
"missing": [
"<string>"
]
}Contact must already exist (created via
POST /leads with channel call, email, or whatsapp).
Same template resolution as create-lead: request emailTemplateId / whatsappTemplateId → campaign Follow-up → Omni default verified profile + attached template.
Get ids from List Omni templates. Optional: templateVariables, whatsappParams, emailScheduledAt, whatsappScheduledAt (default scheduledAt).
| Situation | Response |
|---|---|
| No pending follow-up | 201 scheduled |
| Pending exists | 409 followup_already_pending - pass force: true |
| Call in progress + immediate schedule | 422 contact_busy - use a future scheduledAt |
Authorizations
Paste only your API key (ond_live_… or ond_test_…). Do not type the word Bearer - the playground adds it.
Path Parameters
Body
application/json
Response
Scheduled

