# Submit a new item

### Usage options 
  The usage of  varies depending on its intended use and availability of information. The request payload must include either a  object  a  object. Passing both as a part of the payload may result in processing errors.

  #### Using Source Data Object
  If the attribute values for a transcript are known, send the source data inline in the request using the  object. 

  #### Using Source Data Reference Object

  If the data is in a document, upload it using the  endpoint or make it available at a remote location. A reference to the uploaded document should then be included in the request using the  object. 


Endpoint: POST /v3/items/new
Version: 3.0
Security: Bearer

## Header parameters:

  - `version` (number)
    Version number of the MeasureOne API you wish to integrate.

  - `Authorization` (string)
    Authorization API Key

  - `Content-type` (string)
    Content-type of the request payload. MeasureOne accepts content in application/json format unless specified otherwise

## Request fields (application/json):

  - `datarequest_id` (string)
    MeasureOne generated unique datarequest identifier linked to the item. If this is not provided, MeasureOne will generate a new datarequest for given item.

  - `external_id` (string)
    A customer generated unique identifier linked to the item

  - `datasource_id` (string, required)
    Unique identifier of the datasource. This attribute is non-mandatory  source_data_type

  - `source_data_type` (string, required)
    The type of the source_data
    Enum: "M1_ACADEMIC_RECORD", "M1_DIGEST", "TRANSCRIPT_FILE", "PAYSTUB_FILE", "W2_FILE", "INSURANCE_POLICY (Deprecated)", "AUTO_INSURANCE_POLICY", "HOME_INSURANCE_POLICY", "RENTERS_INSURANCE_POLICY", "UNINSURED_MOTORIST_FORM", "AUTO_INSURANCE_CLAIM", "INSURANCE_CARD", "STUDENT_ID_CARD", "PROCEEDS_1099_B", "TWN_EDR", "FORM_1099_B", "FORM_1099_CONSOLIDATED", "FORM_1099_INT", "FORM_1099_DIV", "FORM_1099_OID", "FORM_1098", "POLICY_LISTING", "POLICY_DETAILS", "VEHICLE_LISTING", "VEHICLE_DETAILS"

  - `media_type` (string)
    Media type of the source data document

  - `refresh_id` (string)
    Unique ID of a scheduled refresh identified by MeasureOne

  - `source_data` (array, required)
    Source data object contains one complete academic record. Multiple source data objects containing  will result in an error

  - `individual_id` (string)
    MeasureOne generated unique identifier linked to the item. If this is not provided, MeasureOne will generate a new individual_id for given item. This attribute is deprecated

## Response 200 fields (application/json):

  - `id` (string)
    ID of the created record

  - `individual_id` (string)
    Unique ID of the individual identified by MeasureOne

  - `datarequest_id` (string)
    Unique ID of the datarequest identified by MeasureOne

  - `processing_status` (string)
    Enum: "IN_PROGRESS", "COMPLETED"

## Response 400 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 401 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error

## Response 405 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds
    Example: 1655227025839

  - `error_code` (string)
    MeasureOne Error code
    Example: "METHOD_NOT_ALLOWED"

  - `error_message` (string)
    Details of the error
    Example: "Given Method not allowed"

## Response 500 fields (application/json):

  - `timestamp` (number)
    Timestamp in milliseconds

  - `error_code` (string)
    MeasureOne Error code

  - `error_message` (string)
    Details of the error