Dex Guide
Dex Dashboard
Keep In Touch

List keep-in-touch cadences

List the workspace's keep-in-touch cadences the caller can see, by `next_due_at` then id: the Team cadences plus the caller's own My cadences, never another member's. Filters: `kind` (`all` default, `

GET /v2/keep-in-touch/cadences

Parameters

Query parameters

kind
string enum
'all' (default) is the Team cadences plus the caller's own My cadences; never another member's.Possible values: "all", "my", "team"
contact_id
string (uuid)
frequency_id
string (uuid)
group_id
string (uuid)
Only cadences whose contact is a direct member of this workspace group (subgroups excluded).
status
string enum
'overdue': due before now; 'upcoming': due now or later.Possible values: "overdue", "upcoming"
due_before
string (date-time)
Exclusive upper bound on next_due_at, for a day window.
include_snoozed
boolean
Default false: cadences snoozed past now are left out.
my_contacts
boolean
Default false. True: only the caller's My Contacts — their own My cadences, and cadences of contacts the caller has a known email, calendar or note interaction with (their own private notes included).
limit
integer
cursor
string

Responses

200 — Successful response

Content-Type: application/json

data
object required
data.cadences
array<object> required
data.cadences[].id
string (uuid) required
data.cadences[].kind
string enum required
Possible values: "team", "my"
data.cadences[].contact_id
string (uuid) required
data.cadences[].frequency_id
string (uuid) required
data.cadences[].days
integer required
data.cadences[].next_due_at
string (date-time) required
data.cadences[].snoozed_until
string (date-time) required
data.cadences[].created_at
string (date-time) required
data.cadences[].updated_at
string (date-time) required
data.cadences[].contact
object required
data.cadences[].contact.id
string (uuid) required
data.cadences[].contact.first_name
string | null required
data.cadences[].contact.last_name
string | null required
data.cadences[].contact.image_url
string | null required
data.cadences[].contact.job_title
string | null
data.pagination
object
data.pagination.nextCursor
string | null
data.pagination.count
integer

Example

{
  "data": {
    "cadences": [
      {
        "id": "00000000-0000-0000-0000-000000000000",
        "kind": "team",
        "contact_id": "00000000-0000-0000-0000-000000000000",
        "frequency_id": "00000000-0000-0000-0000-000000000000",
        "days": 0,
        "next_due_at": "2026-10-23T10:31:51.469Z",
        "snoozed_until": "2026-10-23T10:31:51.469Z",
        "created_at": "2026-10-23T10:31:51.469Z",
        "updated_at": "2026-10-23T10:31:51.469Z",
        "contact": {
          "id": "00000000-0000-0000-0000-000000000000",
          "first_name": "string",
          "last_name": "string",
          "image_url": "string"
        }
      }
    ]
  }
}

400 — Request body failed validation.

Content-Type: application/json

(body)
any

401 — Missing or invalid API key.

Content-Type: application/json

(body)
any

403 — Valid key, insufficient permission.

Content-Type: application/json

(body)
any

404 — Resource does not exist.

Content-Type: application/json

(body)
any

409 — Request conflicts with the current state of the resource.

Content-Type: application/json

(body)
any

429 — Rate limit exceeded.

Content-Type: application/json

(body)
any

500 — Unexpected server error.

Content-Type: application/json

(body)
any

Code samples

curl https://api.prod.getdex.com/v2/keep-in-touch/cadences \
  --header 'Authorization: Bearer YOUR_API_KEY'

Remove related contacts

Unlink one or more related contacts from `{contactId}`. The contacts themselves are NOT deleted — only the relation rows are removed (both stored directions, so legacy double-stored pairs are fully cl

Create a keep-in-touch frequency

Add a frequency of `days` (1 to 3650) to the workspace. Owners and admins only. 409 `frequency_exists` when one of those days exists. Workspace-only: send the `X-Dex-Workspace` header (400 `workspace_

Copyright © 2026