E-File Magic

W-9 requests

Send W-9 requests

Queue W-9 collection links for delivery through the selected channel.

POST
/api/v1/w9/requests/dispatch
Authentication
OAuth 2.0 access token
Required scopes
w9.writew9.dispatch
Idempotency key
Required
Rate-limit cost
5 units

How to use this endpoint

A restricted connection must supply explicit request_ids. Reuse the same idempotency key after an uncertain result to avoid duplicate sends.

Requests must have paid W-9 capacity before they can be sent.

HTML and plain-text request emails show Issuer contact using contact_name, contact_email, and phone from the request's saved issuer snapshot. Blank fields are omitted, and no contact details are substituted from the taxpayer or sending user. Collection and recipient-reconfirmation emails share this behavior; dispatch request/response contracts are unchanged.

Email transmission runs asynchronously. Dispatch acceptance does not confirm provider acceptance or inbox delivery. Inspect each request’s delivery status; notification retries do not rerun the originating dispatch.

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