Reply to thread

POST

threads

{id}

cURL

curl --request POST \
  --url https://app.getozi.com/api/v1/threads/{id}/reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "html": "<string>",
  "inline_images": [
    {
      "cid": "logo",
      "filename": "logo.png",
      "content_base64": "<string>"
    }
  ],
  "draft_id": "cm9msg123",
  "send_at": "2026-10-09T09:00:00Z",
  "expected_recipient": "<string>"
}
'

import requests

url = "https://app.getozi.com/api/v1/threads/{id}/reply"

payload = {
    "text": "<string>",
    "html": "<string>",
    "inline_images": [
        {
            "cid": "logo",
            "filename": "logo.png",
            "content_base64": "<string>"
        }
    ],
    "draft_id": "cm9msg123",
    "send_at": "2026-10-09T09:00:00Z",
    "expected_recipient": "<string>"
}
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({
    text: '<string>',
    html: '<string>',
    inline_images: [{cid: 'logo', filename: 'logo.png', content_base64: '<string>'}],
    draft_id: 'cm9msg123',
    send_at: '2026-10-09T09:00:00Z',
    expected_recipient: '<string>'
  })
};

fetch('https://app.getozi.com/api/v1/threads/{id}/reply', 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.getozi.com/api/v1/threads/{id}/reply",
  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([
    'text' => '<string>',
    'html' => '<string>',
    'inline_images' => [
        [
                'cid' => 'logo',
                'filename' => 'logo.png',
                'content_base64' => '<string>'
        ]
    ],
    'draft_id' => 'cm9msg123',
    'send_at' => '2026-10-09T09:00:00Z',
    'expected_recipient' => '<string>'
  ]),
  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.getozi.com/api/v1/threads/{id}/reply"

	payload := strings.NewReader("{\n  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\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.getozi.com/api/v1/threads/{id}/reply")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.getozi.com/api/v1/threads/{id}/reply")

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  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "sent_at": "2023-11-07T05:31:56Z",
  "scheduled": true,
  "scheduled_id": "<string>",
  "send_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "recipient_changed",
    "message": "<string>"
  }
}

Sends a reply from the conversation’s mailbox to the person who wrote last, and files it in Sent. The reply keeps the conversation together in the recipient’s mail app. The reply can be plain text, formatted html with pictures in inline_images, or both, send_at holds it to send later, and draft_id names a draft of the same mailbox that it replaces (deleted once sent; anything that is not one of the mailbox’s drafts returns 404). See Formatted messages, pictures and scheduling for the rules. Send an Idempotency-Key header to retry safely: the same key with the same body within 24 hours returns the first reply instead of sending again, and the same key with a different body (including different pictures or send_at) returns 409 NOT_UNIQUE.

Needs an API key with full access.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Idempotency-Key

string

Same key and body within 24 hours returns the first reply without sending again; same key with a different body is 409 NOT_UNIQUE.

Required string length: 1 - 256

Path Parameters

string

required

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9_-]+$

Example:

"cm9abc123"

Body

application/json

text

string

Plain-text reply body. Required unless html is given, when it defaults to a plain-text copy of the html.

Required string length: 1 - 2097152

html

string

Formatted body. Cleaned on the server with the sanitizer webmail uses (scripts, forms, event handlers, blocks and unsafe links are dropped) before it is sent. The mailbox signature goes above an element with class "ozi_quote" when there is one, else at the end. When text is left out it is made from the html.

Required string length: 1 - 2097152

inline_images

object[]

Up to 10 pictures shown in the html by cid:, sent as inline attachments. Every cid: the html shows must be supplied, and every picture supplied must be shown.

Maximum array length: 10

Show child attributes

draft_id

string

A draft of the same mailbox this message replaces, such as the one a cancelled scheduled send became. It is deleted once the message is sent (or scheduled), as webmail does. Must be in the mailbox's Drafts folder, else 404.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9_-]+$

Example:

"cm9msg123"

send_at

string<date-time>

RFC 3339 time to send at, from now to a year ahead. The message waits in the mailbox's Scheduled folder until then and can be cancelled, moved or sent now through /v1/scheduled/{id}. Use a few seconds ahead for an undo window.

Example:

"2026-10-09T09:00:00Z"

expected_recipient

string

The address the caller approved the reply for. When it differs from the address the reply would go to (compared case-insensitively, display names ignored), nothing is sent and the response is 409 recipient_changed.

Required string length: 1 - 1024

Response

Sends a reply (plain text, or formatted with inline pictures) from the thread's mailbox to the latest sender, stored in Sent, or in Scheduled when send_at is given

string

required

sent_at

string<date-time>

required

scheduled

boolean

required

True when the message waits to send (send_at was given). It is then in the Scheduled folder until it goes.

scheduled_id

string

When scheduled: the id to cancel, move or send now through /v1/scheduled/{id}. The same as id.

send_at

string<date-time>

When scheduled: when it will be sent.

cURL

curl --request POST \
  --url https://app.getozi.com/api/v1/threads/{id}/reply \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "<string>",
  "html": "<string>",
  "inline_images": [
    {
      "cid": "logo",
      "filename": "logo.png",
      "content_base64": "<string>"
    }
  ],
  "draft_id": "cm9msg123",
  "send_at": "2026-10-09T09:00:00Z",
  "expected_recipient": "<string>"
}
'

import requests

url = "https://app.getozi.com/api/v1/threads/{id}/reply"

payload = {
    "text": "<string>",
    "html": "<string>",
    "inline_images": [
        {
            "cid": "logo",
            "filename": "logo.png",
            "content_base64": "<string>"
        }
    ],
    "draft_id": "cm9msg123",
    "send_at": "2026-10-09T09:00:00Z",
    "expected_recipient": "<string>"
}
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({
    text: '<string>',
    html: '<string>',
    inline_images: [{cid: 'logo', filename: 'logo.png', content_base64: '<string>'}],
    draft_id: 'cm9msg123',
    send_at: '2026-10-09T09:00:00Z',
    expected_recipient: '<string>'
  })
};

fetch('https://app.getozi.com/api/v1/threads/{id}/reply', 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.getozi.com/api/v1/threads/{id}/reply",
  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([
    'text' => '<string>',
    'html' => '<string>',
    'inline_images' => [
        [
                'cid' => 'logo',
                'filename' => 'logo.png',
                'content_base64' => '<string>'
        ]
    ],
    'draft_id' => 'cm9msg123',
    'send_at' => '2026-10-09T09:00:00Z',
    'expected_recipient' => '<string>'
  ]),
  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.getozi.com/api/v1/threads/{id}/reply"

	payload := strings.NewReader("{\n  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\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.getozi.com/api/v1/threads/{id}/reply")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.getozi.com/api/v1/threads/{id}/reply")

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  \"text\": \"<string>\",\n  \"html\": \"<string>\",\n  \"inline_images\": [\n    {\n      \"cid\": \"logo\",\n      \"filename\": \"logo.png\",\n      \"content_base64\": \"<string>\"\n    }\n  ],\n  \"draft_id\": \"cm9msg123\",\n  \"send_at\": \"2026-10-09T09:00:00Z\",\n  \"expected_recipient\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "id": "<string>",
  "sent_at": "2023-11-07T05:31:56Z",
  "scheduled": true,
  "scheduled_id": "<string>",
  "send_at": "2023-11-07T05:31:56Z"
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "recipient_changed",
    "message": "<string>"
  }
}

API Reference

Emails

Contact Books

Contacts

Domains

Campaigns

Analytics

Mailboxes

Reply to thread

Authorizations

Headers

Path Parameters

Body

Response