E-File Magic

Imports

Start an import

Process a configured spreadsheet for its authorized destination filer.

POST
/api/v1/imports/submissions/start
Authentication
OAuth 2.0 access token
Required scopes
imports.write
Idempotency key
Required
Rate-limit cost
25 units

How to use this endpoint

Upload, inspect and configure the spreadsheet mapping before starting. Start accounting-system imports from Integrations in the application. Read submission status and row results to check the outcome.

Native IRS 1220 imports are started in the application. The wizard requires either Import Filers and Recipients or Import Filers and Recipients with Details, with neither preselected. Both choices exclude G/C corrections. General-information imports keep amounts and form details blank and recipients invalid for completion.

Retrying a request? Keep the same idempotency key and body after an uncertain result. A different key can repeat the action.

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/imports/submissions/start' \
  --header 'Authorization: Bearer <access-token>' \
  --header 'Idempotency-Key: <unique-operation-key>' \
  --header 'Content-Type: application/json' \
  --data-binary @request.json

Replace placeholders with your own values. Use the API resource origin provided for your environment.

Create request.json using the documented fields. Field descriptions are not sample values.