ConnectCloud Developers

POST /api/hr/v1/careers/confirm

Module: HR · operationId: confirmCareerApplication · Tag: Careers · Auth: none

The link of the confirmation mail points to the tenant's careers page (https://<subdomain>.<tenant host domain>/karriere/bestaetigen#t=<token>); the page sends the token here when the applicant presses the button (never on opening – mail scanners open links). Confirming twice answers the same; duplicate means an open application of the address to the posting exists already. Unknown and expired tokens answer 404.

Request body

application/json (required)

  • token (string, required): Token of the confirmation link (max length 200)

Example:

{
  "token": "EXAMPLE-confirmation-token-4f9a2c"
}

Responses

  • 200 The application (application/json)
  • 400 Error (application/json)
  • 404 Error (application/json)
  • 429 Error (application/json)

Fields of the 200 answer:

  • postingNumber (integer): Number of the posting
  • postingTitle (string): Title of the posting
  • status (string): confirmed, or duplicate when an open application to the posting exists already (one of confirmed, duplicate)

Example 200 answer:

{
  "postingNumber": 1,
  "postingTitle": "Systemadministrator:in (m/w/d) Microsoft 365",
  "status": "confirmed"
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/hr/v1/careers/confirm' \
  -H 'Content-Type: application/json' \
  --data '{"token":"EXAMPLE-confirmation-token-4f9a2c"}'

View as Markdown · Interactive reference · OpenAPI