E-File Magic

W-9 requests

Import W-9 request rows

Create a W-9 import from rows supplied in the request.

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

Request fields

4 fields
file_nameRequiredstring

Name of the source file being uploaded. Minimum characters: 1. Maximum characters: 80.

rowsRequiredarray<object>

Source rows to create as W-9 requests. Minimum items: 1. Maximum items: 1000.

Nested fields (10)

account_refOptionalstring | null

Maximum characters: 80.

business_nameOptionalstring | null

Maximum characters: 160.

emailRequiredstring (email)

Minimum characters: 3. Maximum characters: 254.

entity_type_cdOptionalstring | null

Allowed values: "B", "I".

issuer_idOptionalstring (uuid) | null

Type: string (uuid) | null.

person_first_nmOptionalstring | null

Maximum characters: 160.

person_last_nmOptionalstring | null

Maximum characters: 160.

person_middle_nmOptionalstring | null

Maximum characters: 160.

person_suffix_nmOptionalstring | null

Maximum characters: 160.

recipient_nameOptionalstring | null

Maximum characters: 160.

dispatch_immediatelyOptionalboolean

Whether to dispatch created W-9 requests as part of this workflow. Default: false.

issuer_idOptionalstring (uuid) | null

ID of the sender issuing the W-9 request.

Headers (3)
AuthorizationRequired
OAuth RS256 access token issued for the EFM API resource. Interactive EFM session tokens are rejected.
Idempotency-KeyRequired
Opaque caller-generated key bound to resolved tenant, connection, and actor scope.
DPoPConditional / optional
Required when the application, connection, or credential is proof-of-possession bound.

Complete request schema: ApiV1W9ImportCreateRequest

cURL request
curl --request POST 'https://api.efilemagic.com/api/v1/w9/imports/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.

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