---
title: "Public Create Import Job"
method: POST
path: "/imports"
tags: ["Campaigns"]
---

# Public Create Import Job

`POST /imports`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/imports`
- Auth: HTTP bearer

## Query parameters

- `campaignId` string, nullable
- `workspaceId` integer, required

## Headers

- `Idempotency-Key` string, nullable

## Response `200`

Successful Response

- CampaignImportEnvelopeOut
  - `import` CampaignImportJobOut
    - `id` integer, nullable
    - `importId` string, nullable
    - `workspaceId` integer, nullable
    - `campaignId` string, nullable
    - `status` string, nullable
    - `filename` string, nullable
    - `contentType` string, nullable
    - `filePath` string, nullable
    - `fileSizeBytes` integer, nullable
    - `totalRows` integer, nullable
    - `processedRows` integer, nullable
    - `successRows` integer, nullable
    - `failedRows` integer, nullable
    - `invalidRows` integer, nullable
    - `mappingStatus` string, nullable
    - `mappingVersion` integer, nullable
    - `idempotencyKey` string, nullable
    - `rowIdempotencyScope` string, nullable
    - `errorCode` string, nullable
    - `errorMessage` string, nullable
    - `meta` object
    - `queuedAt` string, date-time, nullable
    - `startedAt` string, date-time, nullable
    - `completedAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `created` boolean, nullable
  - `deliveryMode` string, nullable
  - `guardrails` object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/6c02339eef43?raw)