---
title: "Request Postal Mailing for Tax Form"
method: POST
path: "/payout/{user_token}/tax/postal"
tags: ["Tax"]
---

# Request Postal Mailing for Tax Form

`POST /payout/{user_token}/tax/postal`

## Request

- Base URL: `https://api.masspay.io/v1.0.0`
- URL: `https://api.masspay.io/v1.0.0/payout/{user_token}/tax/postal`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/masspay/apis/masspay-api/docs/payout/:user_token/tax/postal/post.ts> (a function with typed inputs; its response is checked against the schema)

This **POST** endpoint is used to enable postal mailing for a tax form (1099-K, 1099-NEC, or 1099-MISC) that has **already been transmitted** to the IRS. The form is identified by its `submission_id`, and the form type is detected automatically. A **$1.80 USD** postal mailing fee is charged per successful request. Postal mailing can be requested multiple times for the same submission (e.g., for re-prints) — each request incurs the fee. <br><br> **Note:** Postal orders can only be created for forms that have been transmitted. For forms not yet transmitted, set `is_postal: true` on the PUT (update) endpoint instead.

## Request body

- TaxFormPostalRequest: Request to enable postal mailing for a transmitted tax form
  - `submission_id` string, required: The submission ID of the transmitted form (works for 1099-K, 1099-NEC, and 1099-MISC)

## Response `200`

OK

- TaxFormPostalResponse: Response from postal mailing request
  - `submission_id` string: The submission ID the postal order was created for
  - `record_id` string: The record ID
  - `tax_form` '1099K' | '1099NEC' | '1099MISC': The form type detected from the submission
  - `postal_status` string: Status of the postal order (e.g., 'Order Created')
  - `postal_status_ts` string: Timestamp when the postal order was created
  - `info` string: Additional information about the postal order
  - `fee` number: Postal mailing fee charged for this request
  - `currency` string: Currency of the fee
  - `is_reprint` boolean: True when postal was already enabled for this submission and this request is a re-print

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `404`: Not Found
- `405`: Method Not Allowed.
- `500`: Internal server error.
- `504`: Gateway Time-out.

## Changes

- **2026-11-03** `f9fa41b7c45c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/masspay/apis/masspay-api/changes/payout/:user_token/tax/postal/post.md)

---

[API](https://skmtc.dev/masspay/apis/masspay-api.md) - [All operations](https://skmtc.dev/masspay/apis/masspay-api/llms.txt) - [OpenAPI document](https://skmtc.dev/masspay/apis/masspay-api/revisions/f9fa41b7c45c?raw)