Criar uma tag em um candidato

Headers necessários:

Nome	Valor	Descrição
Authorization	Bearer	Bearer Token para autenticação. Saiba mais aqui.

Uma vez que os Headers estejam devidamente configurados, podemos ir ao próximo passo.

Endpoint utilizado para criar uma tag:

Endpoint	Método	Link para Teste
/api/v2/tags/talent	POST	Loading...

Payload

Definição campo a campo para a criação de tags na API:

Campo	Obrigatório	Tipo	Descrição
application_id	Sim	int	Identificador do candidato na vaga, é possível de se obter através da Visualização de candidatos.
color	Não	string	Caso tenha preferencia em algo, pode definir a cor em hexadecimal. Deixando o campo em branco a cor será escolhida aleatoriamente.
key	Sim	string	Chave para o sistema identificar corretamente a sua tag. Defina-o para "generic".
talent_id	Sim	int	Identificador do talento, também é possível de se obter através da Visualização de candidatos.
value	Sim	string	Nome que se deseja colocar na tag, por exemplo: "Aprovado".

Exemplo de Retorno

{
    "data": {
        "key": "generic",
        "value": "prospect",
        "color": "#3399ff",
        "talent_id": 7896541,
        "application_id": 11845239,
        "manager_id": 14257,
        "company_id": 3102,
        "updated_at": "2025-11-04 15:42:18",
        "created_at": "2025-11-04 15:42:18",
        "_id": "6910bb7a93f6a17d2a4d8a65"
    }
}