Skip to navigation

Assign a tag to a contact

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

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 contact

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. May contain any characters, including spaces and slashes.

Response

Tag assigned

Errors

404
Not Found Error