---
title: "Upload a Smart Import Record to an existing Import"
method: POST
path: "/records/smart-import/{importId}"
tags: ["Records"]
---

# Upload a Smart Import Record to an existing Import

`POST /records/smart-import/{importId}`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/records/smart-import/{importId}`
- Auth: API key in header `Authorization` and OAuth 2
  - Authorization code: `https://ironcladapp.com/oauth/authorize`
  - Client credentials
  - Token URL: `https://ironcladapp.com/oauth/token` scopes: `public.records.createSmartImportRecords`

Upload a file to an existing import and create a record with smart import and predictions. Provide none of recordType, newRecordTypeId, or newRecordTypeDisplayName to default to Imported type. 

**OAuth Scope required:** `public.records.createSmartImportRecords`

## Path parameters

- `importId` string, required

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body `multipart/form-data`

- object
  - `attachment` string, binary, required: Must be a binary. Base64 is not accepted at this time.
  - `recordType` string, required: Upload a smart import record as an existing record type. Cannot provide alongside newRecordTypeId and newRecordTypeDisplayName. Defaults to Imported.
  - `newRecordTypeId` string: The record type ID for a not-yet-existing record type. Must be provided along with a newRecordTypeDisplayName
  - `newRecordTypeDisplayName` string: The display name of the new record type to create.

## Response `200`

200

- object
  - `recordId` string: Record ID of the new created record
  - `importId` string
  - `remainingCredits` number

## Other responses

- `400`: 400
- `403`: 403
- `404`: 404

---

[API](https://skmtc.dev/ironcladapp/apis/ironclad-public-api.md) - [All operations](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/revisions/435da5a4396e?raw)