Skip to main content
GET
List Contact Follow-ups
Retrieves a paginated list of follow-up tasks scheduled for contacts.

Query parameters

  • page (integer, optional): The page number to retrieve. Defaults to 1.
  • limit (integer, optional): The number of records to return per page. Defaults to 20. Maximum permitted limit is 200.
  • search (string, optional): A keyword matching title or notes.

Required permissions

Requires an API key with the crm:read scope.

Authorizations

x-api-key
string
header
required

Workspace API key header. The key implicitly determines your workspace isolation. Scopes: crm:read for GET/HEAD/OPTIONS, crm:write for POST/PATCH/PUT/DELETE.

Query Parameters

page
integer
default:1

Page number to retrieve

limit
integer
default:20

Number of records per page (default: 20, max: 200)

Required range: x <= 200

Search keyword matching follow-up title or notes

Response

Contact follow-ups retrieved successfully

Standard envelope returned by all GET (read) endpoints

status
string
required
Example:

"success"

code
integer
required
Example:

200

message
string
required
Example:

"Integrations public retrieved successfully"

data
object
required

The returned entity, collection, or payload

timestamp
string<date-time>
required
Example:

"2026-10-26T10:00:00.000Z"