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.