API referansı

Communications

4 uç nokta

The unified inbox: email, SMS, WhatsApp and internal notes against a customer or a trip. Sending is asynchronous. A POST with an outbound direction on a deliverable channel returns the queued row immediately and the transport runs after; poll status / sent_at / failed_at, or subscribe to the record webhooks.

Message bodies are PII. A role without that permission sees content_masked: true with subject, preview and both body fields null.

List messages

GET/api/v1/communications

full kapsamlı bir anahtar ister.

Newest first, across every channel. unread_count is the account-wide figure for the key's principal and is returned beside the page, so a badge needs no second call.

Parametreler

Sorgu

qstring
customer_iduuid
trip_iduuid
channelstring
directionenum
şunlardan biriinboundoutboundinternal
thread_idstring
Returns the whole conversation.
scopeenum
şunlardan biriunread
limitintegervarsayılan 25
Rows per page.
cursorstring
Opaque; take it from the previous response's page.next_cursor.

Yanıt · 200

dataobject[]zorunlu
Alanları gösterAlanları gizle
- iduuid
- customer_iduuidnull olabilir
- trip_iduuidnull olabilir
- directionenum
  şunlardan biriinboundoutboundinternal
- channelstring
- statusstringnull olabilir
- subjectstringnull olabilir
- previewstringnull olabilir
  First 160 characters of the plain body.
- content_maskedboolean
  True when the role cannot read message content. subject, preview and both bodies are then null.
- from_addressstringnull olabilir
- to_addressesstring[]
- thread_idstringnull olabilir
- sent_atdate-timenull olabilir
- delivered_atdate-timenull olabilir
- read_atdate-timenull olabilir
- created_atdate-time
- unreadboolean
pageobjectzorunlu
The cursor for the list beside it. Re-send the same request with ?cursor=<next_cursor> while has_more is true. next_cursor is null on the last page.
Alanları gösterAlanları gizle
- next_cursorstringzorunlunull olabilir
- has_morebooleanzorunlu
- limitintegerzorunlu
unread_countintegerzorunlu

Yanıtlar

401Missing or invalid Bearer token
403Policy denied or account has no owner
429Rate limit exceeded

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/communications' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/communications",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/communications",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/communications")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/communications");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

200

{
  "data": [
    {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "direction": "inbound",
      "channel": "email",
      "status": "confirmed",
      "subject": "Confirm the hotel allocation",
      "preview": "Hello Ayşe, your itinerary is attached.",
      "content_masked": true,
      "from_address": "operations@agency.example",
      "to_addresses": [
        "ayse@example.com"
      ],
      "thread_id": "thr_8f14e45fea2c",
      "sent_at": "2026-03-14T09:30:00Z",
      "delivered_at": "2026-03-14T09:30:00Z",
      "read_at": "2026-03-14T09:30:00Z",
      "created_at": "2026-03-14T09:30:00Z",
      "unread": true
    }
  ],
  "page": {
    "next_cursor": "MjAyNi0wMy0xNFQwOTozMDowMC4wMDAwMDBafDk0MQ",
    "has_more": true,
    "limit": 25
  },
  "unread_count": 3
}

Send or log a message

POST/api/v1/communications

full kapsamlı bir anahtar ister.

Two jobs in one endpoint, told apart by direction.

outbound on email, sms or whatsapp queues a real send. The response comes back before the transport runs, so the row you get is the queued one: watch status, sent_at and failed_at to learn the outcome. internal (the default when direction is omitted) records a note against the customer or trip and sends nothing. inbound files a message your own system received.

Reply by carrying the parent's thread_id and setting in_reply_to.

Parametreler

Başlık

Idempotency-Keystring
Your own unique string for this write (a UUID is the obvious choice), max 255 characters. Optional: omit it and nothing changes. Send it and a repeat of the same request returns this call's response verbatim, with Idempotent-Replay: true, instead of writing again.

Gövde

communicationobjectzorunlu
Alanları gösterAlanları gizle
- directionenumvarsayılan internal
  outbound on a deliverable channel queues a real send.
  şunlardan biriinboundoutboundinternal
- channelstring
  email, sms and whatsapp are deliverable.
- customer_iduuid
- trip_iduuid
- company_iduuid
- subjectstring
- body_plainstring
- body_htmlstring
- from_addressstring
- reply_tostring
- in_reply_tostring
- thread_idstring
  Carry the parent's value to keep a reply in its conversation.
- external_idstring
- to_addressesstring[]
- cc_addressesstring[]

Yanıt · 201

dataobject
Alanları gösterAlanları gizle
- iduuid
- customer_iduuidnull olabilir
- trip_iduuidnull olabilir
- directionenum
  şunlardan biriinboundoutboundinternal
- channelstring
- statusstringnull olabilir
- subjectstringnull olabilir
- previewstringnull olabilir
  First 160 characters of the plain body.
- content_maskedboolean
  True when the role cannot read message content. subject, preview and both bodies are then null.
- from_addressstringnull olabilir
- to_addressesstring[]
- thread_idstringnull olabilir
- sent_atdate-timenull olabilir
- delivered_atdate-timenull olabilir
- read_atdate-timenull olabilir
- created_atdate-time
- unreadboolean
- body_plainstringnull olabilir
- body_htmlstringnull olabilir
- cc_addressesstring[]
- reply_tostringnull olabilir
- in_reply_tostringnull olabilir
- external_idstringnull olabilir
  The provider's own id for the message.
- failed_atdate-timenull olabilir
- failure_reasonstringnull olabilir
- metadataobjectnull olabilir
- authorobjectnull olabilir
  A seat on the account, as referenced from other records.
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
  - emailstringnull olabilir
- customerobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
- tripobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - titlestring
- updated_atdate-time

Yanıtlar

401Missing or invalid Bearer token
403Policy denied or account has no owner
422The request was understood but the record could not be written. details maps each rejected attribute to its reasons, so a client can put the message next to the field that caused it.
429Rate limit exceeded

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/communications' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90' \
  -d '{
  "communication": {
    "channel": "email",
    "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "subject": "Your Cappadocia itinerary",
    "body_plain": "Hello Ayşe, your itinerary is attached.",
    "to_addresses": [
      "ayse@example.com"
    ]
  }
}'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/communications",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Content-Type": "application/json",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    body: JSON.stringify({
      "communication": {
        "channel": "email",
        "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
        "subject": "Your Cappadocia itinerary",
        "body_plain": "Hello Ayşe, your itinerary is attached.",
        "to_addresses": [
          "ayse@example.com"
        ]
      }
    }),
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/communications",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Content-Type": "application/json",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
    json={
      "communication": {
        "channel": "email",
        "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
        "subject": "Your Cappadocia itinerary",
        "body_plain": "Hello Ayşe, your itinerary is attached.",
        "to_addresses": [
          "ayse@example.com"
        ]
      }
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/communications")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Content-Type"] = "application/json"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"
request.body = JSON.generate({
  communication: {
    channel: "email",
    customer_id: "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    subject: "Your Cappadocia itinerary",
    body_plain: "Hello Ayşe, your itinerary is attached.",
    to_addresses: [
      "ayse@example.com"
    ]
  }
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/communications");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Content-Type: application/json",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
    CURLOPT_POSTFIELDS     => json_encode([
        "communication" => [
            "channel" => "email",
            "customer_id" => "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
            "subject" => "Your Cappadocia itinerary",
            "body_plain" => "Hello Ayşe, your itinerary is attached.",
            "to_addresses" => [
                "ayse@example.com",
            ],
        ],
    ]),
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

201

{
  "data": {
    "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "direction": "inbound",
    "channel": "email",
    "status": "confirmed",
    "subject": "Confirm the hotel allocation",
    "preview": "Hello Ayşe, your itinerary is attached.",
    "content_masked": true,
    "from_address": "operations@agency.example",
    "to_addresses": [
      "ayse@example.com"
    ],
    "thread_id": "thr_8f14e45fea2c",
    "sent_at": "2026-03-14T09:30:00Z",
    "delivered_at": "2026-03-14T09:30:00Z",
    "read_at": "2026-03-14T09:30:00Z",
    "created_at": "2026-03-14T09:30:00Z",
    "unread": true,
    "body_plain": "Hello Ayşe, your itinerary is attached.",
    "body_html": "<p>Hello Ayşe, your itinerary is attached.</p>",
    "cc_addresses": [
      "accounts@agency.example"
    ],
    "reply_to": "operations@agency.example",
    "in_reply_to": "<message-id@example.com>",
    "external_id": "CRM-88213",
    "failed_at": "2026-03-14T09:30:00Z",
    "failure_reason": "string",
    "metadata": {},
    "author": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz",
      "email": "ayse@example.com"
    },
    "customer": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz"
    },
    "trip": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "title": "Cappadocia, 4 nights"
    },
    "updated_at": "2026-03-14T09:30:00Z"
  }
}

Read a message

GET/api/v1/communications/{id}

full kapsamlı bir anahtar ister.

Adds the full body, the recipient lists and the linked customer and trip.

Parametreler

Yol

iduuidzorunlu

Yanıt · 200

dataobject
Alanları gösterAlanları gizle
- iduuid
- customer_iduuidnull olabilir
- trip_iduuidnull olabilir
- directionenum
  şunlardan biriinboundoutboundinternal
- channelstring
- statusstringnull olabilir
- subjectstringnull olabilir
- previewstringnull olabilir
  First 160 characters of the plain body.
- content_maskedboolean
  True when the role cannot read message content. subject, preview and both bodies are then null.
- from_addressstringnull olabilir
- to_addressesstring[]
- thread_idstringnull olabilir
- sent_atdate-timenull olabilir
- delivered_atdate-timenull olabilir
- read_atdate-timenull olabilir
- created_atdate-time
- unreadboolean
- body_plainstringnull olabilir
- body_htmlstringnull olabilir
- cc_addressesstring[]
- reply_tostringnull olabilir
- in_reply_tostringnull olabilir
- external_idstringnull olabilir
  The provider's own id for the message.
- failed_atdate-timenull olabilir
- failure_reasonstringnull olabilir
- metadataobjectnull olabilir
- authorobjectnull olabilir
  A seat on the account, as referenced from other records.
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
  - emailstringnull olabilir
- customerobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
- tripobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - titlestring
- updated_atdate-time

Yanıtlar

401Missing or invalid Bearer token
403Policy denied or account has no owner
404Resource not found
429Rate limit exceeded

curl -X GET 'https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.get(
    "https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "GET",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

200

{
  "data": {
    "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "direction": "inbound",
    "channel": "email",
    "status": "confirmed",
    "subject": "Confirm the hotel allocation",
    "preview": "Hello Ayşe, your itinerary is attached.",
    "content_masked": true,
    "from_address": "operations@agency.example",
    "to_addresses": [
      "ayse@example.com"
    ],
    "thread_id": "thr_8f14e45fea2c",
    "sent_at": "2026-03-14T09:30:00Z",
    "delivered_at": "2026-03-14T09:30:00Z",
    "read_at": "2026-03-14T09:30:00Z",
    "created_at": "2026-03-14T09:30:00Z",
    "unread": true,
    "body_plain": "Hello Ayşe, your itinerary is attached.",
    "body_html": "<p>Hello Ayşe, your itinerary is attached.</p>",
    "cc_addresses": [
      "accounts@agency.example"
    ],
    "reply_to": "operations@agency.example",
    "in_reply_to": "<message-id@example.com>",
    "external_id": "CRM-88213",
    "failed_at": "2026-03-14T09:30:00Z",
    "failure_reason": "string",
    "metadata": {},
    "author": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz",
      "email": "ayse@example.com"
    },
    "customer": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz"
    },
    "trip": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "title": "Cappadocia, 4 nights"
    },
    "updated_at": "2026-03-14T09:30:00Z"
  }
}

Mark a message read

POST/api/v1/communications/{id}/mark_read

full kapsamlı bir anahtar ister.

Parametreler

Yol

iduuidzorunlu

Başlık

Idempotency-Keystring
Your own unique string for this write (a UUID is the obvious choice), max 255 characters. Optional: omit it and nothing changes. Send it and a repeat of the same request returns this call's response verbatim, with Idempotent-Replay: true, instead of writing again.

Yanıt · 200

dataobjectzorunlu
Alanları gösterAlanları gizle
- iduuid
- customer_iduuidnull olabilir
- trip_iduuidnull olabilir
- directionenum
  şunlardan biriinboundoutboundinternal
- channelstring
- statusstringnull olabilir
- subjectstringnull olabilir
- previewstringnull olabilir
  First 160 characters of the plain body.
- content_maskedboolean
  True when the role cannot read message content. subject, preview and both bodies are then null.
- from_addressstringnull olabilir
- to_addressesstring[]
- thread_idstringnull olabilir
- sent_atdate-timenull olabilir
- delivered_atdate-timenull olabilir
- read_atdate-timenull olabilir
- created_atdate-time
- unreadboolean
- body_plainstringnull olabilir
- body_htmlstringnull olabilir
- cc_addressesstring[]
- reply_tostringnull olabilir
- in_reply_tostringnull olabilir
- external_idstringnull olabilir
  The provider's own id for the message.
- failed_atdate-timenull olabilir
- failure_reasonstringnull olabilir
- metadataobjectnull olabilir
- authorobjectnull olabilir
  A seat on the account, as referenced from other records.
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
  - emailstringnull olabilir
- customerobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - namestringnull olabilir
- tripobjectnull olabilir
  Alanları gösterAlanları gizle
  - iduuid
  - titlestring
- updated_atdate-time
unread_countintegerzorunlu

Yanıtlar

401Missing or invalid Bearer token
403Policy denied or account has no owner
404Resource not found
429Rate limit exceeded

curl -X POST 'https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/mark_read' \
  -H 'Authorization: Bearer sek_YOUR_API_KEY' \
  -H 'Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90'

const response = await fetch(
  "https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/mark_read",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sek_YOUR_API_KEY",
      "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
  },
);

if (!response.ok) throw new Error(`${response.status} ${await response.text()}`);
const data = await response.json();

import requests

response = requests.post(
    "https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/mark_read",
    headers={
        "Authorization": "Bearer sek_YOUR_API_KEY",
        "Idempotency-Key": "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    },
)
response.raise_for_status()
data = response.json()

require "net/http"
require "json"

uri = URI("https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/mark_read")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer sek_YOUR_API_KEY"
request["Idempotency-Key"] = "8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { it.request(request) }
raise response.body unless response.is_a?(Net::HTTPSuccess)
data = JSON.parse(response.body)

<?php
$ch = curl_init("https://YOUR-CELL.lydira.com/api/v1/communications/9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18/mark_read");
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        "Authorization: Bearer sek_YOUR_API_KEY",
        "Idempotency-Key: 8f14e45f-ea2c-4f33-9a3b-6d0c1b7e5a90",
    ],
]);

$data = json_decode(curl_exec($ch), true);
curl_close($ch);

Yanıt

200

{
  "data": {
    "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "customer_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "trip_id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
    "direction": "inbound",
    "channel": "email",
    "status": "confirmed",
    "subject": "Confirm the hotel allocation",
    "preview": "Hello Ayşe, your itinerary is attached.",
    "content_masked": true,
    "from_address": "operations@agency.example",
    "to_addresses": [
      "ayse@example.com"
    ],
    "thread_id": "thr_8f14e45fea2c",
    "sent_at": "2026-03-14T09:30:00Z",
    "delivered_at": "2026-03-14T09:30:00Z",
    "read_at": "2026-03-14T09:30:00Z",
    "created_at": "2026-03-14T09:30:00Z",
    "unread": true,
    "body_plain": "Hello Ayşe, your itinerary is attached.",
    "body_html": "<p>Hello Ayşe, your itinerary is attached.</p>",
    "cc_addresses": [
      "accounts@agency.example"
    ],
    "reply_to": "operations@agency.example",
    "in_reply_to": "<message-id@example.com>",
    "external_id": "CRM-88213",
    "failed_at": "2026-03-14T09:30:00Z",
    "failure_reason": "string",
    "metadata": {},
    "author": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz",
      "email": "ayse@example.com"
    },
    "customer": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "name": "Ayşe Yılmaz"
    },
    "trip": {
      "id": "9d2f7c3a-1b4e-4a7d-8e51-2c0f6b9a4d18",
      "title": "Cappadocia, 4 nights"
    },
    "updated_at": "2026-03-14T09:30:00Z"
  },
  "unread_count": 3
}