Are you a cracked engineer? See your Vamo profile
vamo

Add shortlist members

POST https://api.vamotalent.ai/v2/shortlists/{id}/members
Access
Authenticated
shortlist:update
Cost
Free
Rate limit
30 / minute per account
Quota
None

Add live contacts to a shortlist (idempotent). The shortlist must not be archived.

Path parameters

  • id string required
    max 16 chars

Request body AddMembersRequest application/json

  • contactIds array of string required

    The contacts to add, 1 to 500 at a time. Adding one that is already on the list is not an error.

    min 1 items, max 500 items
  • source object

    Provenance to record on each membership created by this call.

    • kind string required

      How these contacts came to be on the list.

      searchfeedimportmanualmanagedapi
    • ref string

      The subject behind `kind`, for example the agent or saved search that produced them.

      max 200 chars
  • matchReasons object

    Per-contact free-text reason for the match, keyed by contact id, stored on the membership. Contacts you omit simply carry none.

  • bestRepo object

    Per-contact `owner/repo` to use as the outreach anchor (the repository an email refers to), keyed by contact id. For any contact you omit, the anchor is resolved server-side from their top-starred repository, or left empty if there is none.

  • evidence object

    Per-contact matched-repo evidence (the search result’s `matchedRepos`), keyed by contact id, captured so enroll can materialize it into the candidate’s proof-of-work. Omit for a manual or import add, which carries none.

Responses

Add result

  • added array of string required

    Contacts newly added to the list by this call.

  • existing array of string required

    Contacts that were already on the list and were left alone.

vamo

© 2026 Vamo Holdings, Inc.