---
title: "/create"
method: POST
path: "/jobs/create"
---

# /create

`POST /jobs/create`

## Request

- Base URL: `https://api.neverbounce.com/v4.2`
- URL: `https://api.neverbounce.com/v4.2/jobs/create`
- Auth: API key in query parameter `key`

## Request body

- object
  - `input_location` string, required: The type of input being supplied. Accepted values are "remote_url" and "supplied".
  - `input` string, json, required: The input to be verified
  - `auto_parse` boolean: Should we begin parsing the job immediately? (default: false)
  - `auto_start` boolean: Should we run the job immediately after being parsed? (default: false)
  - `run_sample` boolean: Should this job be run as a sample? (default: false)
  - `filename` string: This will be what's displayed in the dashboard when viewing this job
  - `request_meta_data` object: Miscellanious request meta data
    - `leverage_historical_data` boolean: Control historical data usage, set to false to use real-time only verification
  - `allow_manual_review` boolean: Denotes whether or not the job should be allowed to fall into manual review
  - `callback_url` string: An optional URL that we should send events to during the lifecycle of the job
  - `callback_headers` string, json: An optional array of headers that should be included when sending events to the callback_url

## Response `200`

200

- object
  - `status` string
  - `job_id` integer
  - `execution_time` integer

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `adbb35713cc6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/neverbounce/apis/neverbounce-api/changes/jobs/create/post.md)

---

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