REreacherapp
Discovery Agent

Save a profile's creators to a Vault list

Resolve one brief and materialize its entire match set into a named Vault list — the bridge from 'who should I recruit?' to an automation you can actually run, since automations target Vault lists rather than briefs.

This is a snapshot: the list holds the creators matching at save time and does not track the brief afterwards. Re-save to refresh. Pass include_emails: true to store the email list alongside the handles, which an email automation needs. Optional filters narrow what gets saved without editing the brief.

Every matching creator is saved, not just the first page, so this can take a while on a broad brief. The response reports creators_saved.

Requires read_write scope and an Idempotency-Key header. Returns 404 if the profile does not exist or belongs to another shop. Single-shop only.

post/discovery/profiles/{profile_id}/save-to-list

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/discovery/profiles/{profile_id}/save-to-list
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Path parameters

profile_idinteger required

Discovery Agent profile ID.

Headers

Idempotency-Keystring nullable

Request body

list_namestring required

Name for the Vault list.

descriptionstring nullable

Optional list description.

include_emailsboolean

Also save the creators' email list alongside the handle list. Required if you intend to drive an email automation from it.

filtersobject nullable

Extra filters narrowing the saved set, same shape as the AI-search filter payload. The profile itself is not modified.

Response

Successful Response

successboolean required
messagestring required
list_namestring required
creators_savedinteger required
email_list_savedboolean required

Changes

No operation changes recorded.