Gallery Platform API
Reference

Contacts due a follow-up

Surface contacts who have gone quiet — a logged touch exists, but the most recent one predates `inactive_days` (default 30) ago and no open task is already tracking the follow-up. Ordered most-recently-quiet first (the timely nudges). Detection is a plain inactivity query — no model call. With `include_never_contacted`, contacts with no logged touch at all, added before the cutoff, come back as `never_contacted`. `type` keeps one kind of contact in both lists.

GET
/gallery/contacts/follow-ups

Surface contacts who have gone quiet — a logged touch exists, but the most recent one predates inactive_days (default 30) ago and no open task is already tracking the follow-up. Ordered most-recently-quiet first (the timely nudges). Detection is a plain inactivity query — no model call. With include_never_contacted, contacts with no logged touch at all, added before the cutoff, come back as never_contacted. type keeps one kind of contact in both lists.

Authorization

bearerAuth contacts:read
AuthorizationBearer <token>

A gallery API key, sent as Authorization: Bearer gpk_… (or the x-api-key header).

In: header

Scope: contacts:read

Query Parameters

inactive_days?integer

Only contacts with no interaction for at least this many days.

Range7 <= value <= 365
Default30
limit?integer

Page size. Defaults to 20; the maximum is 100.

Range1 <= value <= 50
Default20
include_never_contacted?string

Also list contacts with no logged touch at all, added before the cutoff and with no open task, as never_contacted.

type?string

Keep only contacts of this type, in both lists.

Value in

  • "collector"
  • "institution"
  • "consignor"
  • "lender"
  • "advisor"
  • "press"
  • "curator"
  • "artist"
  • "other"

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

{  "data": [    {      "contact_id": "string",      "name": "string",      "contact_type": "collector",      "company": "string",      "lead_status": "new",      "last_interaction_at": "string",      "days_since_last_interaction": -9007199254740991,      "last_interaction_summary": "string"    }  ],  "inactive_days": -9007199254740991,  "never_contacted": [    {      "contact_id": "string",      "name": "string",      "contact_type": "collector",      "company": "string",      "lead_status": "new",      "created_at": "string"    }  ]}