E-File Magic

W-9 requests

Create or update a W-9 issuer

Save the sender details used on W-9 requests.

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

On success, data contains the fields below. meta includes api_version and request_id. Keep request_id when reporting a problem.

Response fields

28 fields
address_line1May be omittedstring | null

Maximum characters: 512.

address_line2May be omittedstring | null

Maximum characters: 512.

arch_bucketAlways returnedstring | null

Maximum characters: 512.

cityMay be omittedstring | null

Maximum characters: 512.

contact_emailMay be omittedstring | null

Maximum characters: 512.

contact_nameMay be omittedstring | null

Maximum characters: 512.

countryMay be omittedstring | null

Maximum characters: 512.

created_atAlways returnedstring (date-time)

Type: string (date-time).

dba_nameMay be omittedstring | null

Maximum characters: 512.

display_nameAlways returnedstring | null

Maximum characters: 512.

entity_type_cdMay be omittedstring | null

Maximum characters: 512.

is_archivedAlways returnedboolean

Type: boolean.

Complete response schema: ApiV1W9Issuer

Structure · HTTP 200
{
  "data": {
    "address_line1": "string | null",
    "address_line2": "string | null",
    "arch_bucket": "string | null",
    "city": "string | null",
    "contact_email": "string | null",
    "contact_name": "string | null",
    "country": "string | null",
    "created_at": "string (date-time)",
    "dba_name": "string | null",
    "display_name": "string | null",
    "entity_type_cd": "string | null",
    "is_archived": "boolean",
    "issuer_id": "string (uuid)",
    "legal_name": "string | null",
    "name1": "string | null",
    "name2": "string | null",
    "person_first_nm": "string | null",
    "person_last_nm": "string | null",
    "person_middle_nm": "string | null",
    "person_suffix_nm": "string | null",
    "phone": "string | null",
    "postal_code": "string | null",
    "source_id": "string (uuid) | null",
    "source_type": "string | null",
    "state": "string | null",
    "status": "string | null",
    "updated_at": "string (date-time)",
    "version": "integer"
  },
  "meta": {
    "api_version": "v1",
    "request_id": "string"
  }
}

Successful response structure. This outline shows field types, not a response to copy. Expand Response fields for nested properties and optional values.