---
title: "Create a new document"
method: POST
path: "/v1/documents"
---

# Create a new document

`POST /v1/documents`

## Request body

- object
  - `doc_name` string, required — Specify the name of the document that you are creating.
  - `doc_date` string, date, required — Specify the date of the document that you are creating.
  - `category` string, required — Specify the category of the document. Allowed values are "dispatch", or "other".
  - `doc_type` string, required — Specify the type of the document that you are creating. Allowed values are: 'png', 'jpeg', 'jpg', 'pdf'
  - `doc_size` integer, required — Specify the size of the document that you are creating.
  - `driver_id` integer — Specify the ID of the driver for whom you are creating this document. After the creating, the document will sent to the corresponding driver.
  - `ref_no` string — Specify the reference number or the order number that will be attached to the document.
  - `notes` string — Mention any notes for the document. For example, if you are sending a Dispatch related document, you can mention, Dispatch # XXXXX document for Driver # XXXXX.
  - `dispatch_id` integer — If the category of the document is 'dispatch", then you must mention the Dispatch ID as well.
  - `doc_time` string, date — The timestamp on the document.

## Response `200`

200

## Other responses

- `400` — 400
- `403` — 403

---

[API](https://skmtc.net/gomotive/apis/motive.md) · [All operations](https://skmtc.net/gomotive/apis/motive/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gomotive/motive/revisions/c71780e497f5/schema)