Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.daylit.com/llms.txt

Use this file to discover all available pages before exploring further.

The communications API gives you access to every customer interaction Daylit records: email threads synced from connected mailboxes, call sessions logged through Vonage, and manual communication entries you create yourself. You can filter threads by type, direction, invoice, or date range, and attach notes to any thread for internal context.

​
List threads

GET /api/companies/{company_id}/communications/threads
Returns a paginated list of communication threads for the company. By default, each thread group is collapsed to its most recent message (view=thread). Pass view=message to return every individual message.
​
view
string
default:"thread"
thread — one row per thread group (latest message). message — one row per message.
​
communication_type
string
Comma-separated types to include. Values include email, call, note, and manual.
​
direction
string
Filter by direction: inbound or outbound.
​
requires_response
boolean
Filter threads that require a response.
​
is_resolved
boolean
Filter by resolved status.
​
date_from
string
ISO date (YYYY-MM-DD). Filters by timestamp date (inclusive).
​
date_to
string
ISO date (YYYY-MM-DD). Filters by timestamp date (inclusive).

​
Response

​
data
array
List of communication thread objects.
curl --request GET \
  --url "https://your-instance.com/api/companies/{company_id}/communications/threads?customer_id={customer_id}&communication_type=email" \
  --header "Authorization: Token {token}"

​
Get thread detail

GET /api/companies/{company_id}/communications/threads/{thread_id}
Returns a single thread message and all other messages in the same thread group, ordered by timestamp.

​
Response

​
List emails

GET /api/companies/{company_id}/communications/emails
Returns a paginated list of email-type threads synced from connected Nylas mailboxes. Each row represents the latest message in a conversation thread.
​
is_ar_related
boolean
Filter by AR classification. Pass true to show only AR-related emails.

​
Get email thread

GET /api/companies/{company_id}/communications/emails/{thread_id}
Returns a single email thread with all messages in the conversation and their attachments.

​
Response

​
Log manual communication

POST /api/companies/{company_id}/communications/log-manual
Creates a manual communication log entry for outreach that happened outside Daylit — such as a phone call, in-person meeting, or external email. If you pass a scheduled_action_id or scheduled_touchpoint_id, the linked action is automatically marked completed.
​
communication_type
string
required
Type of communication: call, email, meeting, or another supported type.
​
notes
string
required
Notes or summary of the communication. Stored encrypted.
​
direction
string
default:"outbound"
inbound or outbound.
​
subject
string
Subject line. If omitted, a subject is generated from the communication type and customer name.
​
contact_id
string
UUID of the CustomerContact involved.
​
invoice_ids
array
List of invoice UUIDs to link to this communication.
​
timestamp
string
ISO datetime when the communication occurred. Defaults to now.
​
is_resolved
boolean
default:"false"
Whether this communication resolved the outstanding issue.
​
strategy_tags
array
List of strategy tag strings to attach.
​
scheduled_action_id
string
UUID of a ScheduledAction to mark completed after logging.
​
scheduled_touchpoint_id
string
UUID of a ScheduledTouchpoint to mark completed after logging.
Returns the created CommunicationThread object with HTTP 201. 
curl --request POST \
  --url "https://your-instance.com/api/companies/{company_id}/communications/log-manual" \
  --header "Authorization: Token {token}" \
  --header "Content-Type: application/json" \
  --data '{
    "customer_id": "cust-uuid",
    "communication_type": "call",
    "notes": "Spoke with AP manager. She confirmed payment will process on June 5.",
    "invoice_ids": ["inv-uuid-1"],
    "timestamp": "2026-05-12T14:30:00Z",
    "is_resolved": false
  }'

​
List thread notes

GET /api/companies/{company_id}/thread-notes
Returns all notes attached to communication threads for the company.

​
Create thread note

POST /api/companies/{company_id}/thread-notes
Attaches an internal note to a communication thread. Notes are visible only to your team and are not sent to the customer.
​
thread_id
string
required
UUID of the CommunicationThread to attach the note to.
​
content
string
required
Note content.
Returns the created note object with HTTP 201. 
curl --request POST \
  --url "https://your-instance.com/api/companies/{company_id}/thread-notes" \
  --header "Authorization: Token {token}" \
  --header "Content-Type: application/json" \
  --data '{"thread_id": "thread-uuid", "content": "AP confirmed check is in the mail."}'