Skip to navigation
Public API ReferenceApplicants/CandidatesProfile

Assign a tag to an applicant

Assigns a tag (by name) to this applicant. If no tag with this exact name exists yet for the company, one is created.

See GET /api/v1/lookup/applicant-tags to discover existing tag names and avoid near-duplicates.

Assigning the same tag more than once has no additional effect.

The tag name is passed in the request body, not the URL path, since tag names may contain characters (spaces, slashes) that don’t survive path encoding cleanly.

Authentication

AuthorizationBearer

BrightMove OAuth2 client_credentials - use the client_id/client_secret from User > API Keys (or an admin-managed client).

Path parameters

guidstringRequired
Stable public identifier of the applicant

Request

This endpoint expects an object.
namestringRequired

Tag name to assign. If no tag with this exact name exists yet for the company, one is created. See GET /api/v1/lookup/applicant-tags to discover existing tag names and avoid near-duplicates. May contain any characters, including spaces and slashes.

Response

Tag assigned

Errors

404
Not Found Error