# Start an email import

**POST /email-data/{caseId}/start-import-emails**

Queues a job that imports emails from a linked mailbox into the case: chosen threads, the results of one or several searches, or everything (optionally limited to some folders). Returns the job; poll GET import-jobs/:jobId for progress. An extraction-code user may only name a mailbox linked to their own code (404 otherwise).


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters

### Path parameters

- **caseId** (string)



### Body: application/json (object)

- **providerId** (string)

- **extractionCode** (string)

- **notificationEmails** (array[string])
  Additional email addresses to send email to when export completes (other than user email)

- **type** (string)

- **emails** (array[object])

- **searchData** (object)

- **multiQueryData** (object)

- **folderIds** (array[string])
  Restrict the import to these provider folders (folder `id` as returned by fetch-folders). Optional. Applies to import_all, by_search and by_multi_query; ignored for by_thread.

- **importAllSkipPages** (number)
  Number of pages to skip for import all

- **scheduledFor** (string)
  If set, schedule the import to start at this time instead of immediately. Must be in the future.



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)