---
title: "Import prospect with field name in to sequence"
method: POST
path: "/v1/sequences/prospects/import-with-field-name"
tags: ["sequences"]
---

# Import prospect with field name in to sequence

`POST /v1/sequences/prospects/import-with-field-name`

## Request

- Base URL: `https://developer.saleshandy.com` (the document declares no server; this is the origin it was published from)
- URL: `https://developer.saleshandy.com/v1/sequences/prospects/import-with-field-name`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/docs/v1/sequences/prospects/import-with-field-name/post.ts> (a function with typed inputs; its response is checked against the schema)

Ensure that the field names exist in the system. You can import up to **100,000** prospects at a time, with a maximum content size of **90 MB**.

This can be a large request and may take some time to complete. But you will get response immediately after the request is submitted.

On request of this API, you will receive a **requestId** that can be used to check the status of the import process.

To check the status of the import process, you can use the `v1/sequences/prospects/import-with-field-name/status` API.

If there is any error during the import process, you will receive a **CSV file link** containing the error details.

## Request body

- SequenceProspectImportV2Dto
  - `prospectList` string[], required: The array of prospect list. Each prospect is represented by an array of fields.
  - `stepId` number, required: Set the step to which the prospect is to be added
  - `verifyProspects` boolean: Optional. Set to "true" if prospect's email address should be verified
  - `conflictAction` 'overwrite' | 'noUpdate' | 'addMissingFields' | 'upsert', required: Conflict action to take if we attempt to add an already existing prospect | Key | Value | Description | | --- | --- | --- | | `overwrite` | Overwrite | Updates existing fields using data from the CSV. Fields that are currently empty will not be filled in | | `noUpdate` | Skip Existing Prospects | Keeps existing prospect field details unchanged and does not apply any updates. | | `addMissingFields` | Add Missing Fields | Fills in fields that are currently empty using data from the CSV. Existing field data is not changed | | `upsert` | Update All Fields | Updates existing fields using data from the CSV and adds any that are missing. A blank cell clears the existing value |
  - `tags` string[]: Array of tags to be assigned to the imported prospects. If the tag does not exist, it will be created.

## Response `201`

- unknown

## Other responses

- `400`: 4000: Failed to import prospects<br><br>
- `500`: 5001: Internal server error, please try again later<br><br>

## Changes

- **2026-09-16** `a483e105b20f`: 1 info
  - added the new `upsert` enum value to the request property `conflictAction`

[Operation history](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/changes/v1/sequences/prospects/import-with-field-name/post.md)

---

[API](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy.md) - [All operations](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/llms.txt) - [OpenAPI document](https://skmtc.dev/saleshandy/apis/develop-with-saleshandy/revisions/e7a29c931aa7?raw)