---
title: "Create an application for a job"
method: POST
path: "/0/jobs/{id}/applications"
tags: ["jobs"]
---

# Create an application for a job

`POST /0/jobs/{id}/applications`

## Request

- Base URL: `https://api.taleez.com`
- URL: `https://api.taleez.com/0/jobs/{id}/applications`
- Auth: API key in header `X-taleez-api-secret`

If candidate does not exist (search by mail) it will be created, otherwise the application will be added to the existing candidate.<br/><b>Use this endpoint to create a candidate application to a job offer (with answers to the job questions). To link an existing candidate to a job offer, use the '/jobs/{jobId}/candidates' or the '/candidates/{candidateId}/jobs' endpoints.</b><br/>Currently, automatic actions (workflow, automatic e-mails and webhooks) are not triggered by this way.<br/><br/>🔑 You can access this if you have the 'job.application.create' scope activated on your secret key.

## Path parameters

- `id` string, required

## Request body

- JobApplication
  - `firstName` string, required: Candidate first name
  - `lastName` string, required: Candidate last name
  - `email` string: Candidate e-mail
  - `phone` string: Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.
  - `initialReferrer` string: Application initial referer. Default : 'API Taleez'
  - `bypassRequiredQuestions` boolean: True to allow required questions to do not have answer
  - `locationId` integer: Id of the location if necessary
  - `answers` Answer[]: Application answers to the job questions
    - `questionId` integer, required: Job question id
    - `value` string, required: Answer value for question types : INPUT, TEXTAREA, NUMBER, DATE and DOC. For DOC it must contains document original name (ex: my_cv.pdf)
    - `choices` integer[], required: Answer value(s) for question types : CHECKBOX, SELECTMUL, RADIO, SELECT
    - `starValues` StarValue[], required: Answer value for question type STAR
      - `id` integer: Question choice id
      - `value` integer: Rating value, between 0 and 5
    - `docTempId` string, required: Temporary document id. Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages. For DOC questions : docTempId OR docData must be provided
    - `docData` string, required: Document content encoded in Base64. Supported file formats : pdf, doc, docx, rtf, odt, jpeg, png, pages. For DOC questions : docTempId OR docData must be provided
    - `socialLinks` SocialLinks, required
      - `linkedin` string
      - `viadeo` string
      - `twitter` string
      - `github` string
      - `behance` string
      - `other` string
      - `website` string
      - `dribble` string
      - `skype` string

## Response `200`

Application has been created

## Other responses

- `400`: Something's wrong with your request, additional info will be provided in error message

---

[API](https://skmtc.dev/taleez/apis/taleez-api.md) · [All operations](https://skmtc.dev/taleez/apis/taleez-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taleez/apis/taleez-api/revisions/603f1750bc8f?raw)