| Time | Status | User Agent | |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |
#### URL Expired
The URL for this request expired after 30 days.
Create a contractor payment in Zeal. Zeal will process the payment for the contractor the day before the `pay_date`.
Multiple contractor payments may be submitted for the same contractor and the same `pay_date`.
## Returns [Skip link to Returns](https://docs.zeal.com/reference/create-contractor-payment#returns)
Returns boolean indicating success status and contractor payment object if successful.
| attribute | type | description |
| --- | --- | --- |
| success | boolean | Response status |
| data | object | [Contractor Payment](https://docs.zeal.com/reference/contractor-payment-object) object |
| errors | array | If `success` is false, errors contains a list of error objects.
Show child attributes
**message**
type: string
description: Error message
**status**
type: number
description: HTTP response code
**code**
type: number
description: Error code (see [Error codes](https://docs.zeal.com/reference/error-codes) ) |
companyID
string
required
Company ID of employer
contractorID
string
required
ID of Contractor that needs to be paid out
approval_required
boolean
Defaults to false
Set to `true` if this payment requires manual approval by the employer. Otherwise, by default, Zeal will automatically process the payment two business days before the `pay_date`
pay_date
date
required
Pay date for this payment. Formatted as a date in ISO-8601 format (YYYY-MM-DD). If the pay_date falls on a weekend/bank holiday or the current time is after 2 PM two days before the given pay_date, please correct the date and resubmit. We will not roll forward the pay_date automatically
amount
float
Amount that needs to be paid out. Only required if no payment items are present.
payment_items
array
Array of payment item objects. If payment items are present, `amount` is not required.
payment_items
speed
string
enum
Accepts `two_day`, `one_day`, `one_day_no_reserve`, `zero_day`,`zero_day_no_reserve` or `instant` as values ( **Early Access**)
type
string
enum
Defaults to regular
Type of payment. Only `regular` payments are reported on a contractor's Form 1099-NEC.
disbursement
object
The disbursement for how payment will be made. Defaults to `direct_deposit` if left empty.
customerAccountID
string
ID of Customer Account associated with this Contractor Payment
apply_contractor_deductions
boolean
Applies a deduction to this check for each contractor deduction template that is effective at the time of the pay date for the contractor. **Note: Only applicable when payment_items is provided**
metadata
object
Custom metadata object.
# ``200 200
# ``400 400
Updated about 1 month ago
* * *
ShellNodeRubyPHPPython
```
xxxxxxxxxx
curl --request POST \
--url https://api.zeal.com/contractorPayment \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"approval_required": false,
"type": "regular"
}
'
```
application/json
``200 - Result``400 - Result
Updated about 1 month ago