curl --request POST \
--url https://app.demand-iq.com/api/presentations/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"idempotency_key": "reminder-48213-1",
"subject_variant": "reminder",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"deck_id": "3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f",
"source_event_id": "journey-complete-48213",
"skip_if": []
}
'import requests
url = "https://app.demand-iq.com/api/presentations/send"
payload = {
"idempotency_key": "reminder-48213-1",
"subject_variant": "reminder",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"deck_id": "3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f",
"source_event_id": "journey-complete-48213",
"skip_if": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
idempotency_key: 'reminder-48213-1',
subject_variant: 'reminder',
presentation_id: '7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c',
deck_id: '3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f',
source_event_id: 'journey-complete-48213',
skip_if: []
})
};
fetch('https://app.demand-iq.com/api/presentations/send', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.demand-iq.com/api/presentations/send",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotency_key' => 'reminder-48213-1',
'subject_variant' => 'reminder',
'presentation_id' => '7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c',
'deck_id' => '3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f',
'source_event_id' => 'journey-complete-48213',
'skip_if' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.demand-iq.com/api/presentations/send"
payload := strings.NewReader("{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.demand-iq.com/api/presentations/send")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.demand-iq.com/api/presentations/send")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}"
response = http.request(request)
puts response.read_body{
"send_status": "sent",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"delivery_id": "b1e4d7a2-5c3f-4a8e-9d6b-2f0c8e1a7b35"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"code": "SEND_IN_PROGRESS"
}{
"error": "<string>"
}{
"error": "<string>"
}Send a follow-up email for an ingested presentation
Sends a follow-up email, such as a reminder, for a presentation that POST /api/decks/{deckId}/ingest created. Name the presentation with presentation_id, or with the deck_id and source_event_id you passed to ingest. Server-to-server callers authenticate with a Bearer token. A company credential only reaches its own company’s presentations.
Every decided outcome returns 200: sent, skipped with a reason, or failed. AI Presentations records each outcome as one delivery attempt per idempotency_key. A repeated key returns the original result without sending again. The safety checks (suppressed address, parked or failed presentation, no first email sent, reminders turned off for the deck) always run. skip_if only adds conditions.
409 with code SEND_IN_PROGRESS means another call with the same key hasn’t finished. Retry it with the same key. 5xx responses are also safe to retry with the same key.
curl --request POST \
--url https://app.demand-iq.com/api/presentations/send \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"idempotency_key": "reminder-48213-1",
"subject_variant": "reminder",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"deck_id": "3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f",
"source_event_id": "journey-complete-48213",
"skip_if": []
}
'import requests
url = "https://app.demand-iq.com/api/presentations/send"
payload = {
"idempotency_key": "reminder-48213-1",
"subject_variant": "reminder",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"deck_id": "3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f",
"source_event_id": "journey-complete-48213",
"skip_if": []
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
idempotency_key: 'reminder-48213-1',
subject_variant: 'reminder',
presentation_id: '7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c',
deck_id: '3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f',
source_event_id: 'journey-complete-48213',
skip_if: []
})
};
fetch('https://app.demand-iq.com/api/presentations/send', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://app.demand-iq.com/api/presentations/send",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'idempotency_key' => 'reminder-48213-1',
'subject_variant' => 'reminder',
'presentation_id' => '7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c',
'deck_id' => '3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f',
'source_event_id' => 'journey-complete-48213',
'skip_if' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://app.demand-iq.com/api/presentations/send"
payload := strings.NewReader("{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://app.demand-iq.com/api/presentations/send")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://app.demand-iq.com/api/presentations/send")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"idempotency_key\": \"reminder-48213-1\",\n \"subject_variant\": \"reminder\",\n \"presentation_id\": \"7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c\",\n \"deck_id\": \"3f6c2a1e-8b4d-4c7a-9e2f-1d5b7a9c0e4f\",\n \"source_event_id\": \"journey-complete-48213\",\n \"skip_if\": []\n}"
response = http.request(request)
puts response.read_body{
"send_status": "sent",
"presentation_id": "7c2e5f8b-1a4d-4e6f-9b3c-8d0e2f4a6b1c",
"delivery_id": "b1e4d7a2-5c3f-4a8e-9d6b-2f0c8e1a7b35"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"code": "SEND_IN_PROGRESS"
}{
"error": "<string>"
}{
"error": "<string>"
}Authorizations
Body
Name the presentation with presentation_id, or with deck_id and source_event_id together. A request that includes both shapes returns 400.
Response
The outcome