Tasks API

Tasks API Tasks are the to-dos and follow-ups attached to your account — optionally linked to a contact, deal, or campaign. They move through the stages of your task board (your kanban columns) and have a type and priority . This guide covers managing them over the API. Base URL — https://api.relaytiv.com/v1 Authentication — your API key (see Authentication ) Errors & paging — see Errors & Pagination All examples below show the ?apiKey= query form in cURL and the X-API-Key header in JavaScript and Python — either works on every endpoint. The task object { "id": "tsk_abc123", "title": "Call Jane about her quote", "description": "She asked for pricing on the annual plan.", "type": "to_do", "priority": "high", "stage": "stage-1", "due_date": "2026-06-15T09:00:00.000Z", "remind_before_minutes": 15, "contact": "contacts/uid_whatsapp_15551234567", "campaign": "campaigns/abc123", "tags": ["sales"], "notes": "", "source": "api" } type — to_do , faq_update , or your configured task types (see List task types ). priority — none , low , normal , high , or urgent . stage — the id of a stage on your task board (see List task stages ). When omitted on create, the task lands in your first stage. remind_before_minutes — how many minutes before due_date to send a reminder. 0 means at the due time; omit it or send null for no reminder. Must be a whole number from 0 to 1440 (1 day) — anything larger is rejected. The reminder needs a due_date to fire, and rescheduling the task moves the