Create a job

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

The category code that 1099Policy creates for a group of similarly classified jobs.

Job category codes are pre-approved by 1099Policy so you can offer contractors insurance to new jobs on your platform in real time.

To generate pre-approved category codes for a group of similarly classified jobs visit the 1099Policy Dashboard.
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.

Minimum value is 100.
wage_type string Required

One of flatfee, hourly, unit or blended.

Values are flatfee, hourly, unit, or blended.
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.
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.
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.
- category_code string
  
  The category code that 1099Policy creates for a group of similarly classified jobs.
  
  Job category codes are pre-approved by 1099Policy so you can offer contractors insurance to new jobs on your platform in real time.
  
  To generate pre-approved category codes for a group of similarly classified jobs visit the 1099Policy Dashboard.
- 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. 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.
- 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 (e.g., 1500 cents is $15.00). The minimum wage amount is 100 cents US. The maximum wage amount is 100000000 cents US ($1,000,000).
  
  Minimum value is 100, maximum value is 100000000.
- wage_type
  
  One of flatfee, hourly, unit or blended.
  
  Values are flatfee, hourly, unit, or blended.
- years_experience integer
  
  The number of years of experience required to be eligible for the job.

POST /api/v1/jobs

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}'

Request examples

{
  "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
}

Response examples (201)

{
  "address": {
    "country": "null",
    "line1": "92 Geary St",
    "line2": "null",
    "locality": "San Francisco",
    "postalcode": 94114,
    "region": "CA"
  },
  "category_code": "jc_MTqpkbkp6G",
  "created": 1646818364,
  "custom_metadata": {
    "campaign": "Red Bull"
  },
  "description": "Install fiber optic cable from back to the front of the store.",
  "entity": "en_Ah3tqYn",
  "id": "string",
  "name": "Field technician",
  "wage": 15000,
  "wage_type": "flatfee",
  "years_experience": 10
}