Endpoint used to publish job postings in the Vagas.com system within the VaaS context.
The +cargo+, +descrição do anuncio+, and +outros requisitos do anúncio+ support a limited set of HTML tags for text formatting. The allowed HTML tags are listed below.
+Allowed HTML Tags:+
- span
- br
- p
- ul
- ol
- li
- b
- i
- u
- strong
- em
- div
- h1
- h2
- h3
- h4
- h5
- h6
Path parameters
-
Hash identifier of the represented company (
represented_hashin the original document). In this operation the segment identifies the company, not the job.
Body
Required
-
URL where the candidate will be redirected to complete the application process.
-
Phases IDs the job will have, the ids can be obtained in the endpoint
/v1/job-posting/phases. If not sent, the phase withordem1 registered in the company environment will be used. -
List of emails to send notification when the job is published
-
Job title
-
Flag to mark if the job is for people with a disability only
-
Contract type ID. can be obtained in the endpoint
/v1/dominios/modelos-contratuais. If not sent, "CLT" (id 1) will be assumed. -
Número de posições abertas para a vaga. If not sent, the value 1 will be assumed.
-
Required Languages for the job, they can be obtained in the endpoint
/v1/dominios/idiomas -
The IDs can be retrieved from the v1/job-posting/benefits endpoint. The same benefit must not be added more than once to the same job posting. If this field is sent, the “beneficios_txt” field must not be included in the request.
-
This field must be used to send benefits in free-text format. If this field is sent, the “benefits” field must not be included in the request.
-
If the whole object is not sent, "salary to be discussed" will be assumed (
tipo_moeda:BRL,faixa_salario_min:0.0,faixa_salario_max:0.0,exibir_salario_no_anuncio:false). If sent, all 4 attributes below must be sent - sending only some of them returns an error. -
If not sent,
truewill be assumed. The VaaS context does not allow explicitly sending the valuefalse.
curl \
--request POST 'https://apigateway.vagas.com.br/v1/job-posting/vaas/abc123xyz' \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"url_externa": "http://jobexternalurl.com/",
"fases_ids": [
999,
999
],
"notificar": [
"contato@empresa.com",
"rh@email.com"
],
"cargo": "Engenheiro",
"cargo_exclusivo_pcd": false,
"tipo_de_contratacao_id": 999,
"numero_de_posicoes": 1,
"idiomas": [
{
"id": 534,
"nivel_id": 5
}
],
"beneficios": [
{
"id": 2,
"valor": 80
}
],
"benefícios_txt": "Benefits text",
"anuncio": {
"descricao": "Descrição da vaga",
"outros_requisitos": "Ter certificação em Inglês"
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 999,
"faixa_salario_max": 999,
"exibir_salario_no_anuncio": true
},
"pre_requisitos": {
"escolaridade_minima_id": 1,
"nivel_hierarquico_id": 3,
"aceitar_candidaturas_outras_areas": true,
"areas_de_atuacao_ids": [
4,
6,
10
]
},
"atuacao": {
"modelo_de_trabalho": 4,
"local_aceita_candidaturas": "cidades_proximas",
"local_de_trabalho": {
"pais_id": 999,
"estado_id": 999,
"cidade_id": 999
}
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 999
},
"periodo_de_inscricao": {
"data_inicio": "2024/01/01",
"veiculacao_suspensa": false
},
"acesso_restrito": {
"vaga_restrita": false
},
"canais_de_divulgacao": {
"divisao_id": 999,
"parceiros_ids": [
999
]
},
"vaga_inteligente": true
}'
{
"url_externa": "http://jobexternalurl.com/",
"fases_ids": [
999,
999
],
"notificar": [
"contato@empresa.com",
"rh@email.com"
],
"cargo": "Engenheiro",
"cargo_exclusivo_pcd": false,
"tipo_de_contratacao_id": 999,
"numero_de_posicoes": 1,
"idiomas": [
{
"id": 534,
"nivel_id": 5
}
],
"beneficios": [
{
"id": 2,
"valor": 80
}
],
"benefícios_txt": "Benefits text",
"anuncio": {
"descricao": "Descrição da vaga",
"outros_requisitos": "Ter certificação em Inglês"
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 999,
"faixa_salario_max": 999,
"exibir_salario_no_anuncio": true
},
"pre_requisitos": {
"escolaridade_minima_id": 1,
"nivel_hierarquico_id": 3,
"aceitar_candidaturas_outras_areas": true,
"areas_de_atuacao_ids": [
4,
6,
10
]
},
"atuacao": {
"modelo_de_trabalho": 4,
"local_aceita_candidaturas": "cidades_proximas",
"local_de_trabalho": {
"pais_id": 999,
"estado_id": 999,
"cidade_id": 999
}
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 999
},
"periodo_de_inscricao": {
"data_inicio": "2024/01/01",
"veiculacao_suspensa": false
},
"acesso_restrito": {
"vaga_restrita": false
},
"canais_de_divulgacao": {
"divisao_id": 999,
"parceiros_ids": [
999
]
},
"vaga_inteligente": true
}
{
"id": 2505124,
"cargo_exclusivo_pcd": false,
"cargo": "Analista de crédito",
"numero_de_posicoes": 2,
"tipo_de_contratacao_id": 4,
"funcionario_id": 17742,
"empresa_id": 12702,
"data_criacao": "2023-05-03T11:13:34-03:00",
"fases_ids": [
469731,
649710,
641396
],
"canais_de_divulgacao": {
"divisao_id": 67518,
"parceiros_ids": [
11,
10
]
},
"acesso_restrito": {
"vaga_restrita": false
},
"sobre_a_empresa": {
"anuncio_confidencial": false,
"apresentacao_da_empresa": 139
},
"anuncio": {
"descricao": "Descrição da Vaga",
"outros_requisitos": "sem comentários"
},
"periodo_de_inscricao": {
"data_inicio": "2023-05-03",
"data_fim": "2023-05-03T21:00:00-03:00",
"veiculacao_suspensa": false
},
"salario": {
"tipo_moeda": "BRL",
"faixa_salario_min": 1500,
"faixa_salario_max": 2000,
"exibir_salario_no_anuncio": true
},
"idiomas": [
{
"id": 20,
"nivel_id": 2
}
],
"pre_requisitos": {
"escolaridade_minima_id": 60,
"nivel_hierarquico_id": 40,
"areas_de_atuacao_ids": [
70,
1,
124
]
},
"atuacao": {
"modelo_de_trabalho": 2,
"local_aceita_candidaturas": "somente_cidade",
"local_de_trabalho": {
"localizacao_completa": "Angra dos Reis, RJ, Brasil",
"pais": "Brasil",
"estado": "RJ",
"cidade": "Angra dos Reis",
"cidade_id": 60968
}
},
"fichas_gerenciais": [
{
"id": 23
}
],
"beneficios": [
{
"id": 2,
"valor": 34.5
}
],
"fichas": [
{
"id": 147637,
"obrigratoria": true
}
],
"vaga_inteligente": true
}