---
title: "Create a new document (v2)"
method: POST
path: "/v2/documents"
---

# Create a new document (v2)

`POST /v2/documents`

## Request body

- object
  - `uploader_id` integer — Specify the ID of the uploader who is creating the document.
  - `document_form_id` integer — Specify the ID of the form ID.
  - `doc_date` string, date — Specify the date of the document.
  - `ref_no` string — Specify the reference number for the document.
  - `notes` string — Specify any additional notes for the document.
  - `doc_json_fields` string, json — Input for fields defined in form specified via document_form_id
  - `attachments` object[] — The attachment information that you must provide.
    - `doc_name` string — Denotes the name of the file that you are attaching.
    - `doc_size` integer — Denote the size of the attachment.
    - `doc_type` string — The document type that you are attaching. Allowed values are PNG, JPG, JPEG, and PDF.
  - `doc_time` string, date — Denotes the date and time of the upload. If left blank, it will default to the current time.

## Response `201`

201

- object
  - `document` object
    - `id` integer
    - `category` string
    - `ref_no` string
    - `notes` string
    - `doc_date` string
    - `doc_fields` object
      - `notes` string
    - `doc_time` string
    - `uploader` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string
      - `role` string
      - `deactivated_at` unknown
      - `driver_company_id` unknown
    - `attachments` object[]
      - `id` integer
      - `name` string
      - `upload_url` string
      - `doc_type` string
      - `offline_id` unknown
    - `field_docs` unknown
    - `created_at` string
    - `updated_at` string

## 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/versions/c71780e497f5/schema)