Stoked API: Advocates and Prospects

Feature

Week of September 17, 2026

The Stoked API now covers the people in your community as well as their conversations, so your own systems can keep a complete, current copy of your Stoked data.

Advocates and prospects

Two new sets of endpoints list and fetch advocates and prospects. Like conversations, your developer can pull everything once and then fetch only what has changed since the last sync.

Advocates include status, tags, headline and bio, and how many conversations they’ve had
Prospects include status, tags, whether their phone and email are verified, and how many conversations they’ve started

Personal data is a separate permission

On Settings > API Keys, the Advocates and Prospects permissions now turn these endpoints on. Personal data stays off unless you also check Advocates: personal data or Prospects: personal data:

For advocates: names, email, phone, display name and location, address, map coordinates, and custom fields
For prospects: names, email, and phone

Without that permission, those fields are left out of every response, so a key for a dashboard or a report never sees contact details it doesn’t need. Existing keys are unchanged until an admin edits their permissions.

When an advocate’s or prospect’s personal data is erased, the API passes the redaction along on the next sync so it can be removed from your systems too.

Conversations link to their people

Each conversation now links to its advocate and prospect, and each advocate and prospect links to their conversations. The conversations list can also be filtered to a single advocate or prospect, which is handy for showing someone’s full history in a support tool.