E-File Magic

Imports

Create an import

Start a filer-bound spreadsheet import and obtain create-only upload instructions.

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

How to use this endpoint

Provide an authorized filer_id. Upload the file using the returned URL and headers, then inspect and configure its mapping before starting. Retrying the same key and body can return fresh upload instructions for the same pending submission.

Native IRS 1220 imports create multiple filers and run through Imports → Spreadsheets & 1220 in the signed-in application. This public API requires a destination filer and does not launch that workflow.

The signed-in application accepts native file suffixes .irs, .txt, .1220, .dat, and .fire, and probes at most 1,504 bytes for an unknown/no suffix before upload. Filename recognition is only a hint: existing byte-size, checksum, object binding, malware, full structural/control-total, and annual validation checks still apply. This does not expand the public API destination-filer contract.

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/create' \
  --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.