# Create a custom job

Creates a custom job

Endpoint: POST /v1/tours/{tourId}/custom-jobs
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `tourId` (string, required)
    Unique tour identifier (generated by Better Route backend)

## Request fields (application/json):

  - `rawAddress` (string)
    Address in a format suitable for geocoding

  - `countryCode` (string)
    Two letter country code defined in ISO 3166-1
    Example: "US"

  - `externalId` (string,null)
    Optional ID that can used to identify the job. If provided, this value must not collide with externalId on any other job.

## Response 200 fields (application/json):

  - `jobId` (string)
    Internal ID assigned to this job by the backend

  - `waypointId` (string)
    Internal ID of (potentially new) waypoint to which the job has been assigned

## Response 400 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 401 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 404 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)

## Response 500 fields (application/json):

  - `error` (object)
    Error response

  - `error.status` (integer)
    HTTP error status
    Example: 400

  - `error.message` (string)
    Human readable error message
    Example: "'depot' field can't be null"

  - `error.errorCode` (string)
    Machine-friendly error message containing only alphanumeric characters and '.'
    Example: "tour.list.fetch.failed.bad.request"

  - `error.details` (array)