---
title: "Create new Workday"
method: POST
path: "/api/v2/workdays"
tags: ["Workday Import"]
---

# Create new Workday

`POST /api/v2/workdays`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/workdays`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/workdays/post.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to create a new workday instance.

You must supply a username and password for `Basic Authentication` that is the same as your WorkDay Integrator System User.  Failure to provide these credentials  will result in the request being rejected.

Currently `O-Auth` isn't a supported authentication protocol for WorkDay, but will be in the future.

Currently, only one instance is allowed and it must be `Workday Import`.

#### Sample Request
```
curl -X POST https://console.jumpcloud.com/api/v2/workdays/ \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -d '{
    "name": "Workday2",
    "reportUrl":"https://workday.com/ccx/service/customreport2/gms/user/reportname?format=json",
    "auth": {
      "basic": {
        "username": "someDeveloper",
        "password": "notTheRealPassword"
      }
    }
  }'
```

## Headers

- `x-org-id` string

## Request body

- WorkdayInput
  - `auth` AuthInput
    - `basic` object
      - `password` string
      - `username` string
    - `oauth` object
      - `code` string
  - `name` string
  - `reportUrl` string

## Response `201`

- WorkdayOutput
  - `auth` object
    - `basic` AuthInfo
      - `expiry` string
      - `isValid` boolean
      - `message` string
    - `oauth` AuthInfo
      - `expiry` string
      - `isValid` boolean
      - `message` string
  - `id` string
  - `lastImport` string
  - `name` string
  - `reportUrl` string

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)
