---
title: "Create a courier"
method: POST
path: "/v1/courier"
tags: ["Couriers"]
---

# Create a courier

`POST /v1/courier`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/courier`
- Auth: none declared

Register a new courier for the organization's internal fleet with contact and vehicle details.

## Request body

- CreateCourierInputSerializer: Input for creating a courier.
  - `externalidentifier` string, nullable: The external identifier of the courier.
  - `firstname` string, required: The first name of the courier.
  - `lastname` string, required: The last name of the courier.
  - `phonenumber` string, required: The phone number of the courier.
  - `vehicleinfo` VehicleInfo: Response for vehicle info.
    - `type` 'bike' | 'motorbike' | 'cargobike' | 'car' | 'suv' | 'pickup_truck' | 'van' | 'truck' | 'large_van' | 'extra_large_van'
    - `make` string, nullable: The make of the vehicle.
    - `model` string, nullable: The model of the vehicle.
    - `licenseplate` string, nullable: The license plate of the vehicle.
    - `color` string, nullable: The color of the vehicle.
    - `year` string, nullable: The year of the vehicle.
  - `dateofbirth` string, date, nullable: The date of birth of the courier.
  - `workrelationship` 'EMPLOYEE' | 'CONTRACTOR'
  - `driverslicense` string, nullable: The driver's license number of the courier.
  - `vehicleids` string[], nullable: The vehicles of the courier.

## Response `200`

OK

- CourierResponse: Response for courier.
  - `id` string, required: The ID of the courier.
  - `externalidentifier` string, required: The external identifier of the courier.
  - `firstname` string, required: The first name of the courier.
  - `lastname` string, required: The last name of the courier.
  - `phonenumber` string, required: The phone number of the courier.
  - `createdat` string, required: The creation timestamp of the courier.
  - `firstversioncontractids` string[], required: The first version contract IDs of the courier.
  - `vehicleinfo` VehicleInfo, required: Response for vehicle info.
    - `type` 'bike' | 'motorbike' | 'cargobike' | 'car' | 'suv' | 'pickup_truck' | 'van' | 'truck' | 'large_van' | 'extra_large_van'
    - `make` string, nullable: The make of the vehicle.
    - `model` string, nullable: The model of the vehicle.
    - `licenseplate` string, nullable: The license plate of the vehicle.
    - `color` string, nullable: The color of the vehicle.
    - `year` string, nullable: The year of the vehicle.
  - `courierlocation` VehicleLocation, required: Response for vehicle location.
    - `lat` number, required: The latitude of the vehicle location.
    - `lng` number, required: The longitude of the vehicle location.
  - `dateofbirth` string, date, nullable: The date of birth of the courier.
  - `workrelationship` 'EMPLOYEE' | 'CONTRACTOR'
  - `driverslicense` string, nullable: The driver's license number of the courier.
  - `vehicleids` string[], required: The vehicles of the courier.

## Other responses

- `422`: Unprocessable Content

---

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