keep-in-touch

Add keep-in-touch cadences in bulk (v2)

Changed on

Add the Team cadence (kind: 'team'; owners, admins and standard members) or the caller's own My cadence (kind: 'my'; every member, viewers included) on one frequency to up to 1000 contacts (contact_ids). A contact that already has a cadence of that kind is skipped and keeps it unchanged (skipped_existing_contact_ids); a missing, archived or other-workspace contact is skipped too (not_found_contact_ids). Due dates are computed by the server. 400 frequency_not_found; a viewer's Team batch is refused like the single create. The contacts are written in pages that commit independently, so a failed request may have added some cadences: retrying the same body is safe. Workspace-only: send the X-Dex-Workspace header (400 workspace_context_required without it). Requires an Idempotency-Key header. Returns { data: { cadences: [...], skipped_existing_contact_ids, not_found_contact_ids } } with status 201.

post/v2/keep-in-touch/cadences/batch-create

Request

  • Base URL: https://api.prod.getdex.com
  • URL: https://api.prod.getdex.com/v2/keep-in-touch/cadences/batch-create
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required
Example:01HV8N6X7K3P9Q5R2T4Y6W8Z0A

Required. UUID per logical operation, reused on every retry. See apps/rest-api/src/shared/idempotency.ts for the full contract. Missing → 400 BadRequest; same key + different body → 409 Conflict.

Request body

kind'team' | 'my' required
frequency_idstring uuid required
contact_idsstring[] required

Response

Created

Changes