Create a contractor

POST /api/v1/contractors

Creates a new contractor object.

application/json

Body

address object Required
Hide address attributes Show address attributes object
- country string | null
  
  2-letter country code.
- line1 string
  
  Address line 1 (Street address/PO Box).
- line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
- locality string
  
  City/District/Suburb/Town/Village.
- postalcode string
  
  ZIP or postal code.
- region string
  
  2-letter state code.
company_name string

The contractor's business name.
custom_metadata object

Set of key-value pairs that you can attach to an object. Used to store additional information about the contractor in a structured format.
email string Required

The contractor's email address.
first_name string Required

The contractor's first name.
last_name string Required

The contractor's last name.
middle_name string

The contractor's middle name.
phone string

The contractor's phone number.
tax_identification string

The contractor's tax identification number. For example, an employer identification number (EIN) if the contractor operates as a corporate entity or a social security number if the contractor operates as a sole proprietor.
withhold_premium boolean

This indicates whether the contractor is paying premium directly with their credit card (i.e., false) or if the contractor has given the platform that's integrating with 1099Policy permission to withhold the premium payment from their wages and pay the premium on the contractor's behalf (i.e., true). Defaults to false.

Responses

201 application/json

Returns the contractor object if the post succeeded.
Hide response attributes Show response attributes object
- address object
  
  Hide address attributes Show address attributes object
  
  country string | null
  
  2-letter country code.
  
  line1 string
  
  Address line 1 (Street address/PO Box).
  
  line2 string | null
  
  Address line 2 (Apartment/Suite/Unit/Building).
  
  locality string
  
  City/District/Suburb/Town/Village.
  
  postalcode string
  
  ZIP or postal code.
  
  region string
  
  2-letter state code.
- company_name string | null
  
  The contractor's business name.
- created integer(int64)
  
  Time at which the object was created. Measured in seconds since the Unix epoch.
- custom_metadata object
  
  Set of key-value pairs that you can attach to the contractor object. Used for storing additional information in a structured format. Individual keys can be unset by posting an empty value to them. Pass an empty value, e.g. {}, to custom_metadata to unset all keys.
- email string
  
  The contractor's email address.
- first_name string
  
  The contractor's first name.
- id string
- last_name string
  
  The contractor's last name.
- middle_name string | null
  
  The contractor's middle name.
- phone string
  
  The contractor's phone number.
- withhold_premium
  
  This indicates whether the contractor is paying premium directly with their credit card (i.e., false) or if the contractor has given the platform that's integrating with 1099Policy permission to withhold the premium payment from their wages and pay the premium on the contractor's behalf (i.e., true). Defaults to false.
  
  Default value is false.

POST /api/v1/contractors

curl \
 -X POST https://api.1099policy.com/api/v1/contractors \
 -H "Content-Type: application/json" \
 -d '{"email":"[email protected]","phone":"415-474-9088","address":{"line1":"1 Kearny St","region":"CA","locality":"San Francisco","postalcode":94104},"last_name":"Parker","first_name":"Joe","company_name":"Acme Co.","custom_metadata":{"campaign":"Red Bull"},"tax_identification":"12-3456789"}'

Request example

{
  "email": "[email protected]",
  "phone": "415-474-9088",
  "address": {
    "line1": "1 Kearny St",
    "region": "CA",
    "locality": "San Francisco",
    "postalcode": 94104
  },
  "last_name": "Parker",
  "first_name": "Joe",
  "company_name": "Acme Co.",
  "custom_metadata": {
    "campaign": "Red Bull"
  },
  "tax_identification": "12-3456789"
}

Response examples (201)

{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "company_name": "Acme Co.",
  "created": 1646818364,
  "custom_metadata": {
    "campaign": "Red Bull"
  },
  "email": "[email protected]",
  "first_name": "Joe",
  "id": "cn_Ehb3bYa",
  "last_name": "Parker",
  "middle_name": "null",
  "phone": "415-474-9088",
  "withhold_premium": false
}