---
title: "Create an Entities Metadata Import"
method: POST
path: "/entities/metadata-import"
tags: ["Entities"]
---

# Create an Entities Metadata Import

`POST /entities/metadata-import`

## Request

- Base URL: `https://ironcladapp.com/public/api/v1`
- URL: `https://ironcladapp.com/public/api/v1/entities/metadata-import`
- 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.entities.createMetadataImports`

Upload a file (csv, xlsx, jsonl) to create an entities metadata import. The column names must match exactly (case-sensitive) with existing entity metadata properties. File size limit: 25MB 

**OAuth Scope required:** `public.entities.createMetadataImports`

## 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.

## Response `201`

201

- object
  - `importId` string, uuid, required

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `435da5a4396e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ironcladapp/apis/ironclad-public-api/changes/entities/metadata-import/post.md)

---

[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)