# Create a cron | Parsium Docs

Source: https://docs.parseium.com/api/operations/createcron/

# Create a cron

POST

/v1/crons

Parser targets require a database sink. Workflow targets use stage sinks and require a final-stage database sink. Account cron count and minimum-interval limits apply.

## Authorizations

 Section titled “Authorizations ”

- **[apiKeyHeader](/api/#apikeyheader)**
- **[apiKeyQuery](/api/#apikeyquery)**

## Request Body
required

 Section titled “Request Body
required
 ”

 Select media type application/json

 object

 name

required

 string

 <= 100 characters

 description

required

 string

 url

 string format: uri

 schedule

required

Five-field cron expression.

 string

 timezone

 string

 default: UTC

 target

required

 One of:

- [object](#tab-panel-20)
- [object](#tab-panel-21)

 object

 parser_id

required

 string

 urls

required

 Array<string>

 >= 1 items <= 1000 items

 object

 workflow_id

required

 string

 urls

required

 Array<string>

 >= 1 items <= 1000 items

 scrape_config

Fetch override. Credit price depends on browser and proxy settings.

 object

 useBrowser

 boolean

 waitSeconds

 number

 waitForBrowser

 string

 proxy

`default`, `highquality`, `hardcore`, `premium`, or `premium:<country code>`.

 string

 sink

Return data or write rows to an owned database.

 object

 mode

required

 string

 default: return

Allowed values: return database

 database

 string

 /^[a-z0-9-]{1,32}$/

 table

 string

 /^[a-z0-9_]{1,48}$/

 key

Upsert key columns; defaults to `_url` for parser jobs.

 Array<string>

 enabled

 boolean

 default: true

 overlap

 string

 default: skip

Allowed values: skip queue

## Responses

 Section titled “
Responses
”

### 201

 Section titled “201 ”

Cron created.

 Select media type application/json

 object

 id

 string

 next_run_at

 string format: date-time

### 401

 Section titled “401 ”

Missing or invalid API key.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 422

 Section titled “422 ”

Validation failed.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

### 429

 Section titled “429 ”

Request, concurrency, or plan limit exceeded.

 Select media type application/json

 One of:

- [object](#tab-panel-22)
- [object](#tab-panel-23)

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string

 object

 error

required

 string

##### Example

```
pending limit
```

 pending

required

 integer

 limit

required

 integer

 accepted

required

 integer

0

#### Headers

 Section titled “Headers ”

 Retry-After

 integer

Seconds to wait when supplied.

### 503

 Section titled “503 ”

Feature or backing service is unavailable.

 Select media type application/json

 object

 error

required

 string

##### Example

```
invalid request
```

 field

Field that failed validation.

 string

 detail

 string

 hint

 string