---
title: "Create a subscriber import job"
method: POST
path: "/v1/jobs/subscriber-imports"
tags: ["Jobs"]
---

# Create a subscriber import job

`POST /v1/jobs/subscriber-imports`

## Request

- Base URL: `https://api.mailrith.com`
- URL: `https://api.mailrith.com/v1/jobs/subscriber-imports`
- Auth: HTTP bearer

Queues an asynchronous import job from a ready short-lived browser upload. CSV contents never pass through the agent request.

## Headers

- `Idempotency-Key` string

## Request body

- SubscriberImportJobCreateRequest
  - `upload_id` string, required: The ready upload returned by startSubscriberImportUpload. CSV contents are never sent through the agent request.
  - `mappings` object[], required: Map each uploaded CSV column and each Mailrith field only once. Every csv_column value must exactly match a header returned by getSubscriberImportUpload.
    - `csv_column` string, required
    - `field` object, required
      - `type` 'email' | 'name' | 'custom-field' | 'country' | 'subscriber-status', required
      - `custom_field_id` string, nullable
  - `new_tag_name` string, nullable
  - `existing_tag_ids` string[]
  - `sequence_ids` string[]

## Response `202`

The import job was queued.

- object
  - `data` SubscriberImportJob, required
    - `self` string, required: Stable relative Public API path for retrieving this resource.
    - `id` string, required
    - `status` 'Queued' | 'Processing' | 'Completed' | 'Failed', required
    - `imported_count` integer, nullable, required
    - `error_message` string, nullable, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `400`: The request is invalid.

---

[API](https://skmtc.dev/mailrith/apis/mailrith-api.md) · [All operations](https://skmtc.dev/mailrith/apis/mailrith-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailrith/apis/mailrith-api/revisions/41f09536f2da?raw)