Add candidates to a list

Adds one or more candidate profiles to a list, addressed by profile id (candidateIds) and/or external id (candidateProfileExternalIds). Candidates already on the list are skipped, so the call is idempotent. Returns 204 on success, 400 when an external id matches no candidate, and 404 when the list is not found in the caller's organization.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

Candidate list id (UUID).

Body Params

Candidates to add, by profile id and/or external id

Candidates to add to or remove from a list, addressable by Popp candidate profile id and/or by caller-supplied external id. Provide at least one id across the two fields; the combined total cannot exceed 100.

candidateIds
array of uuids
length ≤ 100

Candidate profile ids (UUIDs).

candidateIds
candidateProfileExternalIds
array of strings
length ≤ 100

Candidate profile external ids, resolved to profile ids within the caller's organization. An external id that matches no candidate returns 400.

candidateProfileExternalIds
Responses
204

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json