# Create a contractor

**POST /api/v1/contractors**

Creates a new contractor object.

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

## Parameters

### Body: application/json (object)

- **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: 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`.