---
title: "Créer une absence"
description: "Crée une absence, validée d’emblée.\n\n- Refusée (`400`) notamment si elle chevauche une autre absence, dépasse le solde ou la durée légale d’un événement familial.\n- Sur un mois clôturé, la paie suivante la régularise.\n- Un congé payé est réparti entre `PTO_N`, `PTO_N-1` et `PTO_N-2` selon les soldes, en plusieurs absences si besoin : la réponse renvoie la première, `GET /public/v1/absences` les liste toutes.\n\nJustificatif : envoyez la requête en `multipart/form-data` avec un fichier `proofFile` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip)."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.puncto.fr/llms.txt
> Use this file to discover all available pages before exploring further.

Path: API Puncto › Absences

`POST /public/v1/absences`

Crée une absence, validée d’emblée.

- Refusée (`400`) notamment si elle chevauche une autre absence, dépasse le solde ou la durée légale d’un événement familial.
- Sur un mois clôturé, la paie suivante la régularise.
- Un congé payé est réparti entre `PTO_N`, `PTO_N-1` et `PTO_N-2` selon les soldes, en plusieurs absences si besoin : la réponse renvoie la première, `GET /public/v1/absences` les liste toutes.

Justificatif : envoyez la requête en `multipart/form-data` avec un fichier `proofFile` (pdf, jpg, jpeg, png, webp, heic, txt, csv, xml, json, xlsx, doc, docx, zip).

## Authentication

- `bearerAuth`, http, header `Authorization`

## Request body

_Required._

- `contractMatching` (`createAbsence.contractMatching`; object, required) — Désigne le contrat. Pour un collaborateur, Puncto retient son contrat actif à `eventDate`, à défaut à `startDate`.
  - `type` (`createAbsence.contractMatching.type`; string, required) — Clé de correspondance utilisée par `value`. - `BY_PUNCTO_COLLABORATOR_ID` : `value` est l’identifiant Puncto du collaborateur - `BY_PUNCTO_CONTRACT_ID` : `value` est l’identifiant Puncto du contrat (`GET /public/v1/contracts`), `eventDate` est ignorée
    - one of `"BY_PUNCTO_COLLABORATOR_ID"`, `"BY_PUNCTO_CONTRACT_ID"`
  - `value` (`createAbsence.contractMatching.value`; string, required) — Identifiant Puncto du collaborateur, ou du contrat avec `BY_PUNCTO_CONTRACT_ID`. Depuis votre `foreignErpId`, retrouvez-le avec `GET /public/v1/collaborators?collaboratorForeignErpId=…`.
    - minLength 1
  - `eventDate` (`createAbsence.contractMatching.eventDate`; string, optional) — Date de l’événement, pour choisir le contrat quand le collaborateur en a plusieurs sur le mois.
    - format `date`; example `"2026-10-05"`
- `type` (`createAbsence.type`; string, required) — Les arrêts de travail (`SICK`, `SICK_AT`, `SICK_ATJ`, `SICK_MP`) et les congés parentaux (`PARENTAL`) sont refusés : saisissez-les dans Puncto. - `JNT` : Jours Non Travaillés (forfait jour) - `RTT` : RTT - `COR` : Contrepartie Obligatoire en Repos - `RCR` : Repos Compensateur - `PTO_N` : Congés payés - `PTO_N-1` : Congés payés N-1 - `PTO_N-2` : Congés payés N-2 - `UNPAID` : Congés sans solde - `FAMILY` : Congés familiaux - `REST` : Repos - `SENIORITY` : Ancienneté - `INTERN_CP` : Congé payé stage - `PREGNANCY_EXAM` : Examens obligatoires de grossesse
  - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"REST"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
- `startDate` (`createAbsence.startDate`; string, required) — Premier jour d’absence.
  - format `date`; example `"2026-10-05"`
- `endDate` (`createAbsence.endDate`; string, required) — Dernier jour d’absence, inclus.
  - format `date`; example `"2026-10-05"`
- `onlyHalfDayAtStart` (`createAbsence.onlyHalfDayAtStart`; boolean, required) — Le premier jour, seul l’après-midi est pris.
- `onlyHalfDayAtEnd` (`createAbsence.onlyHalfDayAtEnd`; boolean, required) — Le dernier jour, seule la matinée est prise.
- `foreignErpId` (`createAbsence.foreignErpId`; string, optional) — Identifiant de l’absence dans votre système, unique parmi les absences de l’entreprise : un `foreignErpId` déjà utilisé renvoie `409`.
  - minLength 1; maxLength 255
- `familyEventType` (`createAbsence.familyEventType`; string, optional) — Événement familial. Requis quand `type` vaut `FAMILY`.
  - one of `"mariage_pacs_salarie"`, `"mariage_pacs_enfant"`, `"deces_conjoint_pacs"`, `"deces_enfant_moins_25_oui"`, `"deces_enfant_moins_25_non_parent_oui"`, `"deces_enfant_moins_25_non_parent_non"`, `"deces_personne_charge_moins_25"`, `"deces_parent"`, `"deces_beau_frere_belle_soeur"`, `"deces_frere_soeur"`, `"deces_beau_parent"`, `"deces_autre_ascendant"`, `"deuil_enfant_moins_25"`, `"naissance_adoption"`, `"handicap_enfant"`
- `childArrivalDate` (`createAbsence.childArrivalDate`; string, optional) — Date de naissance de l’enfant, requise pour un congé de naissance. Pour `PREGNANCY_EXAM`, date présumée de l’accouchement, facultative.
  - format `date`
- `pregnancyExamBeneficiary` (`createAbsence.pregnancyExamBeneficiary`; string, optional) — Requis quand `type` vaut `PREGNANCY_EXAM`. - `PREGNANT_EMPLOYEE` : Salariée enceinte ou en parcours de PMA - `PARTNER` : Conjoint, partenaire de PACS ou concubin
  - one of `"PREGNANT_EMPLOYEE"`, `"PARTNER"`

## Example request

```json
{
  "foreignErpId": "absence-123",
  "contractMatching": {
    "type": "BY_PUNCTO_COLLABORATOR_ID",
    "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
  },
  "type": "RTT",
  "startDate": "2026-10-05",
  "endDate": "2026-10-05",
  "onlyHalfDayAtStart": false,
  "onlyHalfDayAtEnd": false
}
```

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.puncto.fr/public/v1/absences \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "foreignErpId": "absence-123",
  "contractMatching": {
    "type": "BY_PUNCTO_COLLABORATOR_ID",
    "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
  },
  "type": "RTT",
  "startDate": "2026-10-05",
  "endDate": "2026-10-05",
  "onlyHalfDayAtStart": false,
  "onlyHalfDayAtEnd": false
}
'
```

### TypeScript

```typescript
const url = 'https://api.puncto.fr/public/v1/absences';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json', Authorization: 'Bearer <token>'},
  body: JSON.stringify({
    foreignErpId: 'absence-123',
    contractMatching: {type: 'BY_PUNCTO_COLLABORATOR_ID', value: 'coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY'},
    type: 'RTT',
    startDate: '2026-10-05',
    endDate: '2026-10-05',
    onlyHalfDayAtStart: false,
    onlyHalfDayAtEnd: false
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.puncto.fr/public/v1/absences"

payload = {
    "foreignErpId": "absence-123",
    "contractMatching": {
        "type": "BY_PUNCTO_COLLABORATOR_ID",
        "value": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY"
    },
    "type": "RTT",
    "startDate": "2026-10-05",
    "endDate": "2026-10-05",
    "onlyHalfDayAtStart": False,
    "onlyHalfDayAtEnd": False
}
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <token>"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
```

## Responses

### 201

Absence créée

#### Example

```json
{
  "startDate": "2019-08-24",
  "endDate": "2019-08-24",
  "duration": 0,
  "durationExplanation": "string",
  "familyEventType": "deces_enfant_moins_25_non_parent_oui",
  "parentalLeaveType": "BIRTH_ADDITIONAL_LEAVE",
  "childArrivalDate": "2019-08-24",
  "pregnancyExamBeneficiary": "PREGNANT_EMPLOYEE",
  "maternityLeaveSituation": "FIRST_OR_SECOND",
  "actualBirthDate": "2019-08-24",
  "hasPathologicalPrenatalState": true,
  "adoptionLeaveSituation": "ONE_CHILD",
  "childArrivalType": "BIRTH",
  "familyProofFile": {
    "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
    "displayFileName": "string",
    "fileType": "PAYSLIP",
    "file": {
      "key": "string",
      "mimeType": "image/jpeg"
    },
    "collaborator": {
      "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string",
      "imageKey": "string"
    },
    "generatedByUserAccount": {
      "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "firstName": "string",
      "lastName": "string"
    },
    "createdAt": "2019-08-24T14:15:22Z"
  },
  "workStoppage": {
    "lastWorkedDay": "2019-08-24",
    "accidentDate": "2019-08-24",
    "diseaseObservationDate": "2019-08-24",
    "proofFile": {
      "id": "cfil_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "displayFileName": "string",
      "fileType": "PAYSLIP",
      "file": {
        "key": "string",
        "mimeType": "image/jpeg"
      },
      "collaborator": {
        "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string",
        "imageKey": "string"
      },
      "generatedByUserAccount": {
        "userAccountId": "uacc_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
        "firstName": "string",
        "lastName": "string"
      },
      "createdAt": "2019-08-24T14:15:22Z"
    },
    "withSubrogation": true,
    "isProlongation": true
  },
  "workStoppageDsn": {
    "declaredForecastEndDate": "2019-08-24",
    "isDsnDeclared": true,
    "resumption": {
      "id": "wsre_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
      "resumptionDate": "2019-08-24",
      "resumptionMotive": "01",
      "signalementRequired": true,
      "trackingStatus": "queued"
    },
    "pendingDeclaration": {
      "kind": "scheduled",
      "scheduledAt": "2019-08-24T14:15:22Z"
    }
  },
  "foreignErpId": "string",
  "contractId": "cont_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "collaboratorId": "coll_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "createdAt": "2019-08-24T14:15:22Z",
  "isLocked": true,
  "lockState": {
    "state": "OPEN"
  },
  "lateInputRegularisation": {
    "status": "PENDING",
    "carrierYear": 0,
    "carrierMonth": 0
  },
  "isDsnLocked": true,
  "id": "abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY",
  "type": "JNT",
  "status": "pending",
  "onlyHalfDayAtStart": true,
  "onlyHalfDayAtEnd": true,
  "collaboratorForeignErpId": "string",
  "isProlongation": true
}
```

- `startDate` (`createAbsence.response.201.startDate`; string, required)
  - format `date`
- `endDate` (`createAbsence.response.201.endDate`; string, required)
  - format `date`
- `duration` (`createAbsence.response.201.duration`; number, required)
- `durationExplanation` (`createAbsence.response.201.durationExplanation`; string, required)
- `parentalLeaveType` (`createAbsence.response.201.parentalLeaveType`; any of, required) — Type de congé parental (congé de maternité, de paternité, d'adoption, supplémentaire de naissance), null pour toute autre absence.
  - any of: `ParentalLeaveType`, `null`
- `foreignErpId` (`createAbsence.response.201.foreignErpId`; string | null, required)
- `contractId` (`createAbsence.response.201.contractId`; string, required) — Identifiant Puncto
- `collaboratorId` (`createAbsence.response.201.collaboratorId`; string, required) — Identifiant Puncto
- `createdAt` (`createAbsence.response.201.createdAt`; string, required) — Date à laquelle la demande d'absence a été posée.
  - format `date-time`
- `isLocked` (`createAbsence.response.201.isLocked`; boolean, required) — True when the absence can no longer be modified: one of its payroll months is closed and no open payslip can carry the regularisation (`lockState.state === 'BLOCKED'`).
- `lockState` (`createAbsence.response.201.lockState`; any of, required) — État de saisie sur les mois couverts par l'absence (saisie tardive possible)
  - any of: `object`, `object`, `object`
- `isDsnLocked` (`createAbsence.response.201.isDsnLocked`; boolean, required) — True when the DSN of the underlying work stoppage is being transmitted or already deposited. The absence can then no longer be edited, cancelled or deleted.
- `id` (`createAbsence.response.201.id`; string, required) — Identifiant Puncto
- `type` (`createAbsence.response.201.type`; string, required)
  - one of `"JNT"`, `"RTT"`, `"COR"`, `"RCR"`, `"PTO_N"`, `"PTO_N-1"`, `"PTO_N-2"`, `"UNPAID"`, `"FAMILY"`, `"PARENTAL"`, `"REST"`, `"SICK"`, `"SICK_AT"`, `"SICK_MP"`, `"SICK_ATJ"`, `"SENIORITY"`, `"INTERN_CP"`, `"PREGNANCY_EXAM"`
- `status` (`createAbsence.response.201.status`; string, required)
  - one of `"pending"`, `"validated"`, `"rejected"`, `"canceled"`, `"technical-cancel"`
- `onlyHalfDayAtStart` (`createAbsence.response.201.onlyHalfDayAtStart`; boolean, required)
- `onlyHalfDayAtEnd` (`createAbsence.response.201.onlyHalfDayAtEnd`; boolean, required)
- `collaboratorForeignErpId` (`createAbsence.response.201.collaboratorForeignErpId`; string | null, required)
- `isProlongation` (`createAbsence.response.201.isProlongation`; boolean, required) — Prolongation d'un arrêt de travail : `workStoppage` est alors l'arrêt initial, avec l'avis de prolongation pour justificatif.
- `familyEventType` (`createAbsence.response.201.familyEventType`; any of, optional)
  - any of: `FamilyEventType`, `null`
- `childArrivalDate` (`createAbsence.response.201.childArrivalDate`; any of, optional)
  - any of: `string`, `null`
- `pregnancyExamBeneficiary` (`createAbsence.response.201.pregnancyExamBeneficiary`; any of, optional) — Examens de grossesse : la salariée enceinte elle-même, ou son conjoint.
  - any of: `PregnancyExamBeneficiary`, `null`
- `maternityLeaveSituation` (`createAbsence.response.201.maternityLeaveSituation`; any of, optional) — Congé de maternité : rang de l'enfant ou naissance multiple, qui fixe la durée légale.
  - any of: `MaternityLeaveSituation`, `null`
- `actualBirthDate` (`createAbsence.response.201.actualBirthDate`; any of, optional) — Congé de maternité : date réelle de l'accouchement, une fois connue.
  - any of: `string`, `null`
- `hasPathologicalPrenatalState` (`createAbsence.response.201.hasPathologicalPrenatalState`; boolean, optional) — Congé de maternité : état pathologique prénatal prescrit (14 jours de plus avant la naissance).
- `adoptionLeaveSituation` (`createAbsence.response.201.adoptionLeaveSituation`; any of, optional) — Congé d'adoption : nombre d'enfants à charge ou adoption multiple, qui fixe la durée légale.
  - any of: `AdoptionLeaveSituation`, `null`
- `childArrivalType` (`createAbsence.response.201.childArrivalType`; any of, optional) — Congé de naissance : naissance ou adoption de l'enfant, purement informatif.
  - any of: `ChildArrivalType`, `null`
- `familyProofFile` (`createAbsence.response.201.familyProofFile`; any of, optional)
  - any of: `ApiCompanyFile`, `null`
- `workStoppage` (`createAbsence.response.201.workStoppage`; object, optional)
  - `lastWorkedDay` (`createAbsence.response.201.workStoppage.lastWorkedDay`; string, required)
    - format `date`
  - `accidentDate` (`createAbsence.response.201.workStoppage.accidentDate`; any of, required)
    - any of: `string`, `null`
  - `diseaseObservationDate` (`createAbsence.response.201.workStoppage.diseaseObservationDate`; any of, required)
    - any of: `string`, `null`
  - `proofFile` (`createAbsence.response.201.workStoppage.proofFile`; any of, required)
    - any of: `ApiCompanyFile`, `null`
  - `withSubrogation` (`createAbsence.response.201.workStoppage.withSubrogation`; boolean, required)
  - `isProlongation` (`createAbsence.response.201.workStoppage.isProlongation`; boolean, required) — Nature de l'arrêt porté par cette absence : prolongation d'un arrêt initial ou arrêt initial.
- `workStoppageDsn` (`createAbsence.response.201.workStoppageDsn`; object, optional) — État déclaratif de l'arrêt de travail porté par cette absence. Renseigné par les listes internes seulement : le calculer suppose de lire les suivis DSN et la reprise, ce que l'API publique ne fait pas. Son absence ne veut donc pas dire « rien à déclarer », mais « information non chargée ici ».
  - `declaredForecastEndDate` (`createAbsence.response.201.workStoppageDsn.declaredForecastEndDate`; any of, required) — Date de fin prévisionnelle (S21.G00.60.003) telle que le signalement d'arrêt l'a déclarée. Null tant qu'aucun signalement n'a abouti : c'est elle qui dit si une reprise est anticipée.
    - any of: `string`, `null`
  - `isDsnDeclared` (`createAbsence.response.201.workStoppageDsn.isDsnDeclared`; boolean, required) — Vrai quand un signalement d'arrêt a été déposé et validé (idFlux obtenu).
  - `resumption` (`createAbsence.response.201.workStoppageDsn.resumption`; any of, required) — Reprise anticipée déclarée sur cet arrêt, le cas échéant.
    - any of: `ApiWorkStoppageResumption`, `null`
  - `pendingDeclaration` (`createAbsence.response.201.workStoppageDsn.pendingDeclaration`; any of, required) — Signalement d'arrêt que l'automatisation doit encore déposer : aucune reprise ne peut être saisie avant lui. Null quand l'arrêt est déclaré, ou que l'automatisation ne le déclarera pas.
    - any of: `ApiPendingWorkStoppageDeclaration`, `null`
- `lateInputRegularisation` (`createAbsence.response.201.lateInputRegularisation`; any of, optional) — Dernière saisie tardive faite sur cette entité, `null` s'il n'y en a pas. Renseigné par les listes internes seulement : son absence veut dire « information non chargée ici ».
  - any of: `ApiLateInputRegularisation`, `null`

### 400

Absence refusée (chevauchement, solde, durée légale…)

#### Example

```json
{
  "error": "Une absence existe déjà sur cette période pour ce contrat"
}
```

- `error` (`createAbsence.response.400.error`; string, required) — Message lisible, en français.
- `errorCode` (`createAbsence.response.400.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 401

Clé d’API absente, invalide ou révoquée

#### Example

```json
{
  "error": "Les endpoints de l’API publique sont réservés aux comptes application."
}
```

- `error` (`createAbsence.response.401.error`; string, required) — Message lisible, en français.
- `errorCode` (`createAbsence.response.401.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 403

Opération hors de l’accès de la clé d’API

#### Example

```json
{
  "error": "Opération interdite"
}
```

- `error` (`createAbsence.response.403.error`; string, required) — Message lisible, en français.
- `errorCode` (`createAbsence.response.403.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 404

Collaborateur ou contrat introuvable

#### Example

```json
{
  "error": "Contrat non trouvé"
}
```

- `error` (`createAbsence.response.404.error`; string, required) — Message lisible, en français.
- `errorCode` (`createAbsence.response.404.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 409

`foreignErpId` déjà utilisé

#### Example

```json
{
  "error": "Une absence existe déjà avec le foreignErpId absence-123 (identifiant Puncto abse_01JB7Q6ZC8V3K9N2M4R5T7W8XY)."
}
```

- `error` (`createAbsence.response.409.error`; string, required) — Message lisible, en français.
- `errorCode` (`createAbsence.response.409.errorCode`; string, optional) — Code stable, sur certaines erreurs.

### 422

Paramètres invalides

#### Example

```json
{
  "errors": [
    {
      "message": "Le champ statut de l’absence doit être une valeur autorisée",
      "rule": "enum",
      "field": "status"
    }
  ]
}
```

- `errors` (`createAbsence.response.422.errors`; array<object>, required)
  - `message` (`createAbsence.response.422.errors.message`; string, required)
  - `rule` (`createAbsence.response.422.errors.rule`; string, required) — Règle de validation en échec.
  - `field` (`createAbsence.response.422.errors.field`; string, required) — Chemin du champ, par exemple `absences.0.type`.


Source: https://docs.puncto.fr/reference/absences/create/index.md
