## Create a job

### API

POST
/api/v1/jobs

Creates a new job object. Used to classify the work that 1099Policy applies to insure the contractor.

application/json

#### Body
- **address**  
  object  
    The job address where the work will be done. Exclude if job will be done remotely.

- **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 Required  
      2-letter state code.

- **category_code**  
  string Required  
  The category code that 1099Policy creates for a group of similarly classified jobs.

- **custom_metadata**  
  object  
  Set of key-value pairs that you can attach to an object. Used to store additional information about the job in a structured format.

- **description**  
  string Required  
  A description of the job that includes the role, responsibilities and necessary qualifications.

- **entity**  
  string Required  
  The ID of an existing entity for whom the job is being done.

- **name**  
  string Required  
  The name of the contractor job role.

- **wage**  
  integer Required  
  A positive integer representing the wage (e.g., 1500 cents is $15.00). The minimum wage amount is $1.00 US.

- **wage_type**  
  string Required  
  One of `flatfee`, `hourly`, `unit` or `blended`.

- **withhold_premium**  
  boolean  
  This indicates whether the contractor is paying premium directly with their credit card.

- **years_experience**  
  integer  
  The number of years of experience required to be eligible for the job.

### Responses
- **201**  
  application/json  
  Returns the job object if the post succeeded.

- **address**  
      object  
      The job address where the work will be done. Exclude if job will be done remotely.

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

- **category_code**  
      string  
      The category code that 1099Policy creates for a group of similarly classified jobs.

- **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 job object. Used for storing additional information in a structured format.

- **description**  
      string  
      A description of the job that includes the role, responsibilities and necessary qualifications.

- **entity**  
      string  
      The entity ID for whom the work is being done.

- **id**  
      string  
      Unique identifier for the object.

- **name**  
      string  
      The name of the contractor job role.

- **wage**  
      integer  
      A positive integer representing the total wage.

- **wage_type**  
      string  
      One of `flatfee`, `hourly`, `unit` or `blended`.

- **years_experience**  
      integer  
      The number of years of experience required to be eligible for the job.

### Example cURL Request
```curl
curl \
 --request POST 'https://api.1099policy.com/api/v1/jobs' \
 --header "Content-Type: application/json" \
 --data '{"address":{"country":"null","line1":"92 Geary St","line2":"null","locality":"San Francisco","postalcode":94114,"region":"CA"},"category_code":"string","custom_metadata":{},"description":"string","entity":"string","name":"string","wage":42,"wage_type":"flatfee","withhold_premium":true,"years_experience":42}'
```

### Example Response
```json
{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "category_code": "string",
  "custom_metadata": {},
  "description": "string",
  "entity": "string",
  "name": "string",
  "wage": 42,
  "wage_type": "flatfee",
  "withhold_premium": true,
  "years_experience": 42
}
```