RecruteiInstall

Summary

Create a new job vacancy.

Inputs

• title (required) — The title of the vacancy, e.g., "Desenvolvedor Front-end".
• description (required) — A simple HTML/CSS formatted description of the vacancy, e.g.,

  Responsibilities:

  • Develop applications...
  .
• company_department_id (required) — The internal department ID associated with the vacancy, obtainable via the "List Departments" endpoint.
• regime_id (required) — The work regime ID associated with the vacancy, obtainable via the "List Regimes" endpoint.
• quantity (required) — The number of positions for the vacancy, e.g., 5.
• workload (required) — The expected weekly workload for the vacancy, e.g., "40 hours".
• pipe_id (required) — The ID of the flow/kanban the vacancy will use, obtainable via the "List Pipes" endpoint.
• remote (required) — Defines if the vacancy is remote, hybrid, or in-person, selected from predefined options.
• type (required) — Specifies if the vacancy is confidential or public.
• fixed_remuneration (required) — Indicates if the remuneration is fixed or a range.
• remuneration — The remuneration amount, only used when fixed_remuneration is 1.
• remuneration_from — Minimum salary for the vacancy, only used when fixed_remuneration is 0.
• remuneration_to — Maximum salary for the vacancy, only used when fixed_remuneration is 0.
• remuneration_type — Defines the remuneration type: hourly, monthly, or yearly.
• expired_at — The expiration date for the vacancy against new applications.
• client_id — The associated client ID if applicable, obtainable via the "List Clients" endpoint.
• request_reason_id — ID of the reason for requesting the vacancy, obtainable via the "List Request Reasons" endpoint.
• city — City of the vacancy, can be NULL for remote positions.
• state — State of the vacancy in UF, can be NULL for remote positions.
• country — Country of the vacancy, can be NULL for remote positions.
• skills — List of required skills for the vacancy, separated by commas.
• benefits — List of benefits associated with the vacancy, separated by commas.
• internal_code — Internal code for company control (optional).
• time_to_hire — Expected hiring date for the vacancy, not shared with candidates.
• managers — Comma-separated IDs of recruiters responsible for the vacancy.
• internal_information — Any internal notes associated with the vacancy.
• external (required) — Defines if the vacancy is external for clients or internal.
• pcd — Defines if the opportunity is inclusive for people with disabilities (PCD).
• is_inclusive — Defines if the vacancy is inclusive/affirmative for diversity.
• show_client (required) — Specifies if the associated client should be displayed.
• show_remuneration (required) — Specifies if the remuneration can be visible to candidates.
• show_location (required) — Specifies if the location of the vacancy is visible to candidates.
• show_regime (required) — Specifies if the work regime of the vacancy can be visible to candidates.

Output shape

a response containing the details of the created vacancy

Includes all relevant vacancy information as defined in the operation.

Examples

Example 1: Create a job vacancy for a software developer with a detailed description and defined skills.

Provide mandatory details such as title, description, and associated department ID in the parameters.