Update or Correct Form 1099-NEC

This PUT endpoint is used to update or correct a previously submitted Form 1099-NEC (Nonemployee Compensation) for a specific user identified by their user_token. The system automatically determines whether to perform an Update (if the form has not yet been accepted by the IRS) or a Correction (if the form has already been accepted by the IRS). Basic information (name, address, email, phone, TIN) is retrieved from the user's existing profile.
To use this endpoint, you need to provide the user_token as a parameter in the URL Path, the original submission_id, and the updated 1099-NEC form data in the request body. For corrections after IRS acceptance, you can specify the correction_type as VOID, RECIPIENT, AMOUNT, or RECIPIENT_AMOUNT.

Path Params
string
required
Body Params
string
enum
required

Tax year of the Form 1099-NEC

Allowed:
number
0 to 9999999999.99

Box 1: Supplemental Nonemployee compensation amount. When provided, this amount will be added to the total amount of payouts and loads (deducting spendbacks) that were initiated in the tax year Either this or nonemployee_compensation is required

number
0 to 9999999999.99

Box 1: Nonemployee compensation amount. When provided, this will be the total amount reported. Either this or supplemental_nonemployee_compensation is required

boolean
Defaults to false

Box 2: Check if $5,000 or more of consumer products sold for resale

number
0 to 9999999999.99

Box 3: Excess golden parachute payments

number
0 to 9999999999.99

Box 4: Federal income tax withheld

string
length between 4 and 20

Account number for reference when multiple 1099-NEC forms are filed for the same recipient

state_filing
array of objects

State filing information

state_filing
boolean
Defaults to false

When set to true, once the return is transmitted, the 1099-NEC form copy will be mailed to the recipient's address via USPS.

Note: Postal Orders for Foreign Address will not be created.

string

Optional email address to receive the tax form link; if provided, the form link will be sent to this address, and if omitted, no email will be sent.

string
required

The original submission ID to update or correct

boolean

Set to true to VOID the original filing (zeros out all amounts). Use this when the form should not have been filed at all.

Responses

404

Not Found

Language
Credentials
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json