E-File Magic

W-9 requests

Upload a W-9 request list

Create a W-9 import and get upload instructions for its spreadsheet.

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

How to use this endpoint

Send every returned upload header unchanged. Temporary source files are eligible for deletion after two days. Retrying the same key and body can renew the upload URL for the same pending submission. After upload, inspect the file and start the import.

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/w9/imports/create_upload' \
  --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.