# Create a schedule

**POST /v1/schedule**

Allows submitting a new schedule with the provided configuration. Returns the created schedule.


## Servers
- https://api.crontap.com: https://api.crontap.com ()


## Authentication methods
- Api key & Client


## Parameters
### Headers
- **ClientId** (string)

- **ApiKey** (string)




### Body:  (object)
📝 Notes 
 __interval__ is the cron interval e.g. __* * * * *__. Get help in [CronTool ↗️](https://tool.crontap.com/cronjob-debugger) 
 __timezone__ is the timezone the interval should run in. See [api.crontap.com/timezones](https://api.crontap.com/timezones) for a list of all timezones. 
 __headers__ are optional and can be used to send custom headers with the request. 
 __data__ is optional and can be used to send custom payload with the request. 
 __integrations__ are optional and can be used to send a request to a third party or your own API when the schedule is triggered (successfully or not depending on the __callOnSuccess__ option). 
 __label__ is optional and only used to easier identify a schedule
- **url** (string)

- **verb** (string)

- **interval** (string)

- **timezone** (string)

- **headers** (object)

- **integrations** (array[object])

- **data** (object)

- **label** (string)



## Responses
### 200
Schedule object.

#### Body:  (object)
- **id** (string)

- **status** (string)

- **url** (string)

- **verb** (string)

- **interval** (string)

- **timezone** (string)

- **createdAt** (string)

- **updatedAt** (string)

- **headers** (object)

- **data** (object)

- **integrations** (array[object])

- **label** (string)


### 400
Bad Request

#### Body:  (object)
- **error** (string)


### 401
Unauthorized

#### Body:  (object)
- **error** (string)


### 404
Not Found

#### Body:  (object)
- **error** (string)


### 500
Internal Error

#### Body:  (object)
- **error** (string)



[Powered by Bump.sh](https://bump.sh)