Confirm an application with the token of the mail's link (public)
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 postingpostingTitle(string): Title of the postingstatus(string): confirmed, or duplicate when an open application to the posting exists already (one ofconfirmed,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"}'