---
title: "Creates availability dates for a single temp candidate"
method: POST
path: "/Entity/TempCandidateAvailabilityDates"
tags: ["Entity"]
---

# Creates availability dates for a single temp candidate

`POST /Entity/TempCandidateAvailabilityDates`

Multiple availability dates can be created in one request per candidate

The Start and End date must be valid e.g Start date can not be after end date
            
To create availability set the IsAvailable property to True and the UnavailabilityReasonId property to null

To create unavailability set the IsAvailable property to False and the UnavailabilityReasonId to a valid unavailability reason
            
The UnavailabilityReasonId field must match active reference data from the /Reference/UnavailabilityReasons method

## Request body

- TempCandidateAvailabilityDatesRequest
  - `CandidateId` integer, required
  - `AvailabilityDates` TempCandidateAvailabilityDateRequest[], required
    - `Start` string, date-time, required
    - `End` string, date-time, required
    - `TimeZoneId` string, required
    - `IsAvailable` boolean, required
    - `UnavailabilityReasonId` integer, nullable

## Response `200`

OK - List of new availability records

- CandidateAvailabilityResult[]
  - `Id` integer, required
  - `Start` string, date-time, required
  - `End` string, date-time, required
  - `TimeZoneId` string, required
  - `IsAvailable` boolean, required
  - `UnavailabilityDetail` CandidateUnavailabilityDetail
    - `UnavailabilityReason` UnavailabilityReason, required
      - `IsActive` boolean
      - `Id` integer
      - `Name` string, nullable
      - `Color` Color
        - `R` integer
        - `G` integer
        - `B` integer
        - `A` integer
        - `IsKnownColor` boolean
        - `IsEmpty` boolean
        - `IsNamedColor` boolean
        - `IsSystemColor` boolean
        - `Name` string, nullable
    - `PlacementId` integer, nullable
  - `IsReadOnly` boolean, required
  - `CanDelete` boolean, required

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `404` — NotFound

---

[API](https://skmtc.dev/vslcloud/apis/infinity-api.md) · [All operations](https://skmtc.dev/vslcloud/apis/infinity-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vslcloud/infinity-api/revisions/54661781612a/schema)