# Create a session

**POST /api/v1/apply/sessions**


Creates a session object.



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



## Parameters



### Body: application/json (object)

- **cancel_url** (string)
  The URL the contractor will be directed to if they are ineligible or decide to abandon the insurance application and return to your website.

- **contractor** (string)
  The ID of the contractor (required for general opt-in sessions). For standard sessions, this is derived from the quote.

- **general_opt_in_work_state** (string)
  The work state for general opt-in sessions (e.g., "CA", "NY"). Required when `is_general_opt_in` is `true`.

- **is_general_opt_in** (boolean)
  Set to `true` to create a general opt-in session (not tied to a specific job/quote). When `true`, `contractor` and `work_state` are required, and `quote` is not required.

- **quote** (string)
  The ID of an existing quote to be associated with the insurance application session.

- **success_url** (string)
  The URL to which 1099Policy should direct independent contractors when a contractor successfully procures insurance coverage.



## Responses
### 201
Returns the session object for an insurance application if quote, job, and contractor are valid.

#### Body: application/json (object)
- **cancel_url** (string)
  The URL the contractor will be directed to if they are ineligible  or decide to abandon the insurance application and return  to your website.

- **created** (integer(int64))

- **expired** (boolean)
  Indicates whether the insurance application session has expired. If true, the contractor will be redirected to the cancel_url.

- **id** (string)

- **quote** (string)
  The ID of the quote associated with the insurance application session.

- **step** (string)
  The step in the insurance application process that the contractor  is currently on. The contractor will be redirected to this step  when they return to the insurance application. One of `verify_info`, `application_questions`, `esignature_document`, `add_card_details`, `final_review`, or `application_complete`.

- **success_url** (string)
  The URL to which 1099Policy should direct independent contractors  when a contractor successfully procures insurance coverage. 

- **url** (string)
  The URL to the insurance application Session. Redirect customers to  this URL to take them to their insurance application. The domain will  use apply.1099policy.com.



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