# Create a contractor

**POST /api/v1/contractors**


Creates a new contractor object.



## Servers
- Production server: https://api.1099policy.com (Production server)



## Parameters



## Body parameters
Content-type: application/json

- **address** (object)
  
- **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)
  The contractor's email address.
- **first_name** (string)
  The contractor's first name.
- **last_name** (string)
  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: Returns the contractor object if the post succeeded.

#### Body Parameters: application/json (object)
- **address** (object)
  
- **company_name** (string | null)
  The contractor's business name.
- **created** (integer(int64))
  
- **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`. 


[Powered by Bump.sh](https://bump.sh)