SautiDesk
SautiDesk API
Sales

List the activity types of a lead

GET
/v1/desk/activity-types

Lists the things an agent does to move a deal, such as an intro call or a site visit, each with its icon, the stage it moves a lead to, the temperature it sets, its default reminder and the outcomes it offers. Archived types are left out unless you pass include_archived=true. Answers 403 desk.sales_off while Sales is switched off.

Requires: desk.read scope, Converse or Contacts licence, Pro plan.

Authorization

bearerAuth
AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Query Parameters

include_archived?boolean

true to include archived rows, after the live ones.

cursor?string

next_cursor from the previous page. Leave it out for the first page.

limit?integer

Page size: 100 by default, 100 at most.

Response

OK

Example

{  "data": [    {      "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",      "name": "Amina Wanjiru",      "position": 1,      "archived_at": "2026-10-14T08:30:00Z",      "icon": "example",      "moves_to_stage_id": "74f72131-cabe-46a6-9783-ee6f3635a602",      "sets_temperature": "example",      "default_reminder_minutes": 30,      "daily_target": 1,      "outcome_ids": [        "83fecbb0-ec34-4a4f-9047-58b4fe165861"      ]    }  ],  "next_cursor": "eyJvIjoyNX0",  "has_more": false}
FieldTypeDescription
datarequiredobject[]
idrequiredstring (uuid)
namerequiredstringA name for it.
positionrequiredintegerWhere it sits in the list, starting at 0.
archived_atrequiredstring (date-time) | null
iconrequiredstring
moves_to_stage_idrequiredstring (uuid) | null
sets_temperaturerequiredstring | null
default_reminder_minutesrequiredinteger
daily_targetrequiredinteger | null
outcome_idsrequiredstring (uuid)[]
next_cursorrequiredstring | null
has_morerequiredboolean
curl -X GET "https://api.sautidesk.com/v1/desk/activity-types"