> For the complete documentation index, see [llms.txt](https://docs.tracr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tracr.com/tracr-help-pages/integration/integration-tool-new-session.md).

# Integration Tool - New Session

Use the Integration Tool to upload your data files to your instance of the Tracr Platform. To begin, create a new session from the Session history page by selecting the New session button. Then provide a prepared CSV file containing your diamond data.

{% stepper %}
{% step %}

### Prepare your diamond data for upload

There are templates to help you prepare the CSV file and a Data Dictionary in the Integration toolkit, which describes the information you must include in your CSV file for rough, split, or polished diamond data.

* Do not mix different types of data in your CSV file.
* It is recommended that you use a text editor to edit the file.
  {% endstep %}

{% step %}

### Upload your CSV file

The CSV file contains the diamond data and details of any supporting files you want to upload to Tracr.

* Either drag and drop your prepared CSV file onto the page, or select the Or, select from device button to browse for and select the file you want to upload.
  {% endstep %}

{% step %}

### Confirm the integration type

It is important that the type you select matches the type defined in your CSV file. If not, you will get an error.

Select your integration type, and then select Continue.
{% endstep %}

{% step %}

### Validation

Tracr checks your CSV file. See the validation outcomes below.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Ensure the integration type you select exactly matches the type declared in your CSV file — mismatches will cause an error during validation.
{% endhint %}

<details>

<summary>Validation outcomes</summary>

* If validation is successful, Tracr displays the Required files page with the Session overview tab selected. You must then upload the files declared in the CSV file (ensuring that the filenames match) before you can complete the upload.
* If validation fails, Tracr displays the Upload failed page. Review the error text and make the appropriate changes to your CSV file. Select Quit and create a new session to upload the changed file.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.tracr.com/tracr-help-pages/integration/integration-tool-new-session.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.