Post Job

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-en/mcp

Standard setup for AI tools providing an mcp.json file

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

Close
POST /job-posting/vaas/{job_id}

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

  • job_id string Required

    Hash identifier of the represented company (represented_hash in the original document). In this operation the segment identifies the company, not the job.

application/json

Body Required

  • url_externa string Required

    URL where the candidate will be redirected to complete the application process.

  • fases_ids array[integer]

    Phases IDs the job will have, the ids can be obtained in the endpoint /v1/job-posting/phases. If not sent, the phase with ordem 1 registered in the company environment will be used.

  • notificar array[string]

    List of emails to send notification when the job is published

  • cargo string Required

    Job title

  • cargo_exclusivo_pcd boolean

    Flag to mark if the job is for people with a disability only

  • tipo_de_contratacao_id integer

    Contract type ID. can be obtained in the endpoint /v1/dominios/modelos-contratuais. If not sent, "CLT" (id 1) will be assumed.

  • numero_de_posicoes integer

    Número de posições abertas para a vaga. If not sent, the value 1 will be assumed.

  • idiomas array[object]

    Required Languages for the job, they can be obtained in the 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] Required

    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.

    Hide beneficios attributes Show beneficios attributes object
    • id integer Required
    • valor number
  • benefícios_txt string Required

    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.

  • anuncio object
    Hide anuncio attributes Show anuncio attributes object
    • descricao string Required
    • outros_requisitos string
  • salario object

    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.

    Hide salario attributes Show salario attributes object
    • tipo_moeda string

      Currency of the salary, if exibir_salario_no_anuncio is true, this field is required

      Values are BRL or USD.

    • faixa_salario_min number

      Minimum value of the salary range, if exibir_salario_no_anuncio is true, this field is required

    • faixa_salario_max number

      Maximum vlaue of the salary range, if exibir_salario_no_anuncio is true, this field is required

    • exibir_salario_no_anuncio boolean Required

      If false, the salary will be in agreement

  • pre_requisitos object
    Hide pre_requisitos attributes Show pre_requisitos attributes object
    • escolaridade_minima_id integer

      Minimum education level, the ID can be obtained in the endpoint v1/dominios/niveis_de_escolaridade If education is indifferent to the job, pass the value "-1". If not sent, "-1" (Indifferent) will be assumed.

    • nivel_hierarquico_id integer Required

      Hierarchical level. The ID can be obtained in the endpoint /v1/dominios/niveis_hierarquicos

    • aceitar_candidaturas_outras_areas boolean

      If true, the job will accept applications from other areas

    • areas_de_atuacao_ids array[integer] Required

      Fields of activity of the job. The IDs can be obtained in the endpoint /v1/dominios/setores

  • atuacao object
    Hide atuacao attributes Show atuacao attributes object
    • modelo_de_trabalho integer

      Work model. The ID can be obtained in the endpoint /v1/dominios/modelos-locais-trabalho. If not sent, "On-site" (id 1) will be assumed.

    • aceitar_candidaturas Deprecated

      DEPRECATED

    • local_aceita_candidaturas string

      Enum with the location which the application is accepted, apenas da cidade, cidades próximas or qualquer cidade. If the value is somente_cidade, accepts applicants who have registered the city of the job in the region of interest with the "Use my address" option turned on. If the value is cidades_proximas, accepts applicants who have registered the city of the job in the region of interest with the "Use my address" option turned on that are close to the city of the job (distance of up to 50 km). If the value is qualquer_cidade, accepts applicants who have registered the city of the job in the region of interest.

      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

        Country ID The ID can be obtained in the endpoint /v1/dominios/paises/.

      • estado_id integer

        State ID The ID can be obtained in the endpoint /v1/dominios/paises/:pais_id/estados.

      • cidade_id integer

        City ID The ID can be obtained in the 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

      Confidential job If true, the company's name will not be displayed in the job description. If not sent, false will be assumed.

    • apresentacao_da_empresa integer

      If not sent (and anuncio_confidencial is false), the presentation with the highest id registered in the company environment will be assumed.

  • periodo_de_inscricao object Required
    Hide periodo_de_inscricao attributes Show periodo_de_inscricao attributes object
    • data_inicio string Required

      Job start date. Must be set to the current date when the job is published.

    • veiculacao_suspensa boolean

      Must always be false.

  • acesso_restrito object
    Hide acesso_restrito attribute Show acesso_restrito attribute object
    • vaga_restrita boolean

      Must always be false. If not sent, false will be assumed.

  • canais_de_divulgacao object
    Hide canais_de_divulgacao attributes Show canais_de_divulgacao attributes object
    • divisao_id integer

      Job division. The ID can be obtained in the endpoint /v1/job-posting/divisions. If not sent, the division with the lowest id registered in the company environment that is not of type Internal Recruitment will be assumed. If there is no eligible division, the request will return an error.

    • parceiros_ids array[integer]
  • vaga_inteligente boolean

    If not sent, true will be assumed. The VaaS context does not allow explicitly sending the value 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/{job_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://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
}'
Request examples
{
  "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
}
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
}