Publicar Vaga

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL


        
          
            https://vaas.vag.as/doc/publicacao-vagas-vaas-pt/mcp

Standard setup for AI tools providing an mcp.json file

{
  "publicacao-vagas-vaas-pt MCP server": {
    "url": "https://vaas.vag.as/doc/publicacao-vagas-vaas-pt/mcp"
  }
}

POST /job-posting/vaas/{id}

O auth2

Endpoint para publicar vaga no sistema Vagas.com Empresas no contexto VaaS.

Os atributos cargo, descrição do anuncio e outros requisitos do anúncio aceitam algumas tags HTML para formatação do texto, as opções permitidas estão listadas abaixo.

Tags HTML permitidas:

span
br
p
ul
ol
li
b
i
u
strong
em
div
h1
h2
h3
h4
h5
h6

Path parameters

id string Required

Hash identificador da empresa representada (hash_representado no documento original). Nesta operação o segmento identifica a empresa, não a vaga.

application/json

Body Required

url_externa string Required
fases_ids array[integer]

IDs das fases que a vaga terá, os ids podem ser obtidos no endpoint /v1/job-posting/phases. Caso não seja enviado, será assumida a fase de ordem 1 cadastrada no ambiente da empresa.
notificar array[string]

Lista de emails para notificar quando a vaga for publicada
cargo string Required

Titulo da vaga
cargo_exclusivo_pcd boolean
tipo_de_contratacao_id integer

Id do tipo de contratação. Pode ser obtido no endpoint /v1/dominios/modelos-contratuais. Caso não seja enviado, será assumido "CLT" (id 1).
numero_de_posicoes integer

Número de posições abertas para a vaga. Caso não seja enviado, será assumido o valor 1.
idiomas array[object]

Idiomas necessários para a vaga, as opções podem ser obtidas no endpoint /v1/dominios/idiomas
Hide idiomas attributes Show idiomas attributes object
- id integer Required
- nivel_id integer Required
  1 - não tem
  
  2 - Básico
  
  3 - Intermediário
  
  4 - Avançado
  
  5 - Fluente
  Values are 1, 2, 3, 4, or 5.
beneficios array[object]

Os IDs podem ser obtidos por meio do endpoint v1/job-posting/benefits. Um mesmo benefício não pode ser adicionado mais de uma vez à mesma vaga. Caso este campo seja enviado, o campo “beneficios_txt” não deve ser enviado na requisição.
Hide beneficios attributes Show beneficios attributes object
- id integer Required
- valor number
benefícios_txt string Required

Este campo deve ser utilizado para o envio dos benefícios em formato de texto livre. Caso este campo seja enviado, o campo “benefícios” não deve ser enviado na requisição.
anuncio object
Hide anuncio attributes Show anuncio attributes object
- descricao string Required
- outros_requisitos string
salario object

Caso o objeto inteiro não seja enviado, será assumido salário "a combinar" (tipo_moeda: BRL, faixa_salario_min: 0.0, faixa_salario_max: 0.0, exibir_salario_no_anuncio: false). Caso seja enviado, todos os 4 atributos abaixo devem ser enviados - o envio parcial retorna erro.
Hide salario attributes Show salario attributes object
- tipo_moeda string
  
  Moeda em que será pago o salário, se exibir_salario_no_anuncio for true, esse campo é obrigatório
  
  Values are BRL or USD.
- faixa_salario_min number
  
  Valor minimo da faixa de salário, se exibir_salario_no_anuncio for true, esse campo é obrigatório
- faixa_salario_max number
  
  Valor máximo da faixa de salário, se exibir_salario_no_anuncio for true, esse campo é obrigatório
- exibir_salario_no_anuncio boolean Required
  
  Se false o salário será a combinar
pre_requisitos object
Hide pre_requisitos attributes Show pre_requisitos attributes object
- escolaridade_minima_id integer
  
  Nível mínimo de escolaridade, o id pode ser obtido no endpoint v1/dominios/niveis_de_escolaridade Caso a escolaridade seja indiferente para a vaga passe o valor "-1". Caso não seja enviado, será assumido "-1" (Indiferente).
- nivel_hierarquico_id integer Required
  
  Nivel hieraquico da vaga. O id pode ser obtido no endpoint /v1/dominios/niveis_hierarquicos
- aceitar_candidaturas_outras_areas boolean
  
  Se true, a vaga aceitará candidaturas de outras áreas de atuação
- areas_de_atuacao_ids array[integer] Required
  
  Areas de atuação da vaga. Os ids podem ser obtidos no endpoint /v1/dominios/setores
atuacao object
Hide atuacao attributes Show atuacao attributes object
- modelo_de_trabalho integer
  
  Modelo de local de trabalho. O id pode ser obtido no endpoint /v1/dominios/modelos-locais-trabalho. Caso não seja enviado, será assumido "Presencial" (id 1).
- aceitar_candidaturas Deprecated
  
  DEPRECATED
- local_aceita_candidaturas string
  
  Enum com o local de onde aceita candidatura, apenas da cidade, cidades próximas ou qualquer cidade. Se o valor for somente_cidade, aceita candidatos que tenham cadastrado a cidade da vaga na região de interesse com a opção "Usar meu endereço" ligada. Se o valor for cidades_proximas, aceita candidatos que tenham cadastrado a cidade da vaga na região de interesse com a opção "Usar meu endereço" ligada que sejam próximas da cidade da vaga (distância de até 50 Km). Se o valor for qualquer_cidade, aceita candidatos de tenham cadastrado a cidade da vaga na região de interesse.
  
  Values are somente_cidade, cidades_proximas, or qualquer_cidade.
- local_de_trabalho object Required
  Hide local_de_trabalho attributes Show local_de_trabalho attributes object
  
  pais_id integer
  
  Id pode ser oobtido no endpoint /v1/dominios/paises/.
  
  estado_id integer
  
  Id pode ser oobtido no endpoint /v1/dominios/paises/:pais_id/estados.
  
  cidade_id integer
  
  Id pode ser obtido no endpoint /v1/dominios/paises/:pais_id/estados/:estado_id/cidades.
sobre_a_empresa object
Hide sobre_a_empresa attributes Show sobre_a_empresa attributes object
- anuncio_confidencial boolean
  
  Se o valor for true, o nome da empresa não aparecerá na descrição da vaga. Caso não seja enviado, será assumido false.
- apresentacao_da_empresa integer
  
  Caso não seja enviado (e anuncio_confidencial for false), será assumida a apresentação de maior id cadastrada no ambiente da empresa.
periodo_de_inscricao object Required
Hide periodo_de_inscricao attributes Show periodo_de_inscricao attributes object
- data_inicio string Required
- veiculacao_suspensa boolean
acesso_restrito object
Hide acesso_restrito attribute Show acesso_restrito attribute object
- vaga_restrita boolean
  
  Deve ser sempre falso. Caso não seja enviado, será assumido false.
canais_de_divulgacao object
Hide canais_de_divulgacao attributes Show canais_de_divulgacao attributes object
- divisao_id integer
  
  Divisão da vaga. O id pode ser obtido pelo endpoint /v1/job-posting/divisions. Caso não seja enviado, será assumida a divisão de menor id cadastrada no ambiente da empresa que não seja do tipo Recrutamento Interno. Caso não haja nenhuma divisão elegível, a requisição retornará erro.
- parceiros_ids array[integer]
vaga_inteligente boolean

Caso não seja enviado, será assumido true. O contexto VaaS não permite o envio explícito do valor false.

Responses

200 application/json

OK
Hide response attributes Show response attributes object
- id integer
- cargo_exclusivo_pcd boolean
- cargo string
- numero_de_posicoes integer
- tipo_de_contratacao_id integer
- funcionario_id integer
- empresa_id integer
- data_criacao string
- fases_ids array[integer]
- canais_de_divulgacao object
  
  Hide canais_de_divulgacao attributes Show canais_de_divulgacao attributes object
  
  divisao_id integer
  
  parceiros_ids array[integer]
- acesso_restrito object
  
  Hide acesso_restrito attribute Show acesso_restrito attribute object
  
  vaga_restrita boolean
- sobre_a_empresa object
  
  Hide sobre_a_empresa attributes Show sobre_a_empresa attributes object
  
  anuncio_confidencial boolean
  
  apresentacao_da_empresa integer
- anuncio object
  
  Hide anuncio attributes Show anuncio attributes object
  
  descricao string
  
  outros_requisitos string
- periodo_de_inscricao object
  
  Hide periodo_de_inscricao attributes Show periodo_de_inscricao attributes object
  
  data_inicio string
  
  data_fim string
  
  veiculacao_suspensa boolean
- salario object
  
  Hide salario attributes Show salario attributes object
  
  tipo_moeda string
  
  Values are BRL or USD.
  
  faixa_salario_min number
  
  faixa_salario_max number
  
  exibir_salario_no_anuncio boolean
- idiomas array[object]
  
  Hide idiomas attributes Show idiomas attributes object
  
  id integer
  
  nivel_id integer
- pre_requisitos object
  
  Hide pre_requisitos attributes Show pre_requisitos attributes object
  
  escolaridade_minima_id integer
  
  nivel_hierarquico_id integer
  
  areas_de_atuacao_ids array[integer]
- atuacao object
  
  Hide atuacao attributes Show atuacao attributes object
  
  modelo_de_trabalho integer
  
  local_aceita_candidaturas string
  
  Values are somente_cidade, cidades_proximas, or qualquer_cidade.
  
  local_de_trabalho object
  
  Hide local_de_trabalho attributes Show local_de_trabalho attributes object
  
  localizacao_completa string
  
  pais string
  
  estado string
  
  cidade string
  
  cidade_id integer
- fichas_gerenciais array[object]
  
  Hide fichas_gerenciais attribute Show fichas_gerenciais attribute object
  
  id integer
- beneficios array[object]
  
  Hide beneficios attributes Show beneficios attributes object
  
  id integer
  
  valor number
- fichas array[object]
  
  Hide fichas attributes Show fichas attributes object
  
  id integer
  
  obrigratoria boolean
- vaga_inteligente boolean

POST /job-posting/vaas/{id}

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://urlexternadavag.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
}'

Request examples

{
  "url_externa": "http://urlexternadavag.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
}

Response examples (200)

{
  "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
}