1 of 6

Data Share

Pre-fill application questions, increase program profitability.

Authentic Application

To purchase an insurance policy, a customer must fill out an application with their businesses information which can take fifteen minutes to complete. Alternatively, we provide you with the option to pre-fill application questions with customer data you probably already have — this can reduce the time down to approximately 5 minutes.

Benefits of Pre-filling:

Improves accuracy of your insurance program. The performance of a program is correlated to the amount of accurate policyholder information. Using customer data from a trusted partner will help Authentic better price and underwrite your customers (customers can also edit and update any pre-filled fields that may be out of date).
Higher conversion rate for your insurance program. Fewer questions mean customers have to spend less time filling out their application.

Every application has three distinct parts:

Lead section: includes basic customer information that pre-qualifies them for a policy.
Policy section: assesses the customer's risk-profile, additional business operation specific questions and contains information such as limits and start date.
Exposure section: collects information for each location of operation.

Getting started with prefilling data

We recommend our partners start by passing us data for some of these commonly prefilled application questions
Once this is complete, partners are able to pass data for any additional fields we collect in our application; here is our full list of application questions

Data Sharing via Widget

Here is a guide to pre-filling authentic application question fields through our embedded widget

You can pre-fill data about your customer by passing in their information to the prefillData key of the widget configuration:

authenticWidget.init({
  insurancePortal: {
    url: "https://<tenant-name>.<environment>.authenticinsurance.com",
  },
  customerId: "unique_cid1",
  prefillData: {
    lead: {
      email: "customer@email.com",
      stateCodes: ["OH"],
    },
    responses: {
      exposures: [{
        id: "1",
        exposureName: "business_location",
        fieldValues: {
          "ADDRESS": "100 street, UNIT 2, city, OH 33333, US",
        }
      }],
      questions: {
        "BUSINESS_LEGAL_NAME": "Customer Business Name",
      }
    }
  }
});

The complete interface for PrefillData is shown below:

interface PrefillData {
  lead?: {
    email?: string;
    businessClassCode?: string;
    stateCodes?: string[];
    productIds?: string[];
  };
  responses?: {
    exposures?: Array<{
      id: string;
      exposureName: string;
      fieldValues: Record<string, string>;
    }>;
    questions?: Record<string, string>;
  };
};

Each exposure is uniquely identified by an ID. This can be as simple as the index of the element in the array or a unique UUID.

Please visit the Commonly Prefilled Questions section to find the full data dictionary of the fields that can be passed in. Specifically, please see the first table, Fields for Widget Integration.

Data Sharing via URL

Here is a guide to pre-filling authentic application question fields through the URL

Forwarding data to your Authentic application flow is as simple as attaching one search parameter to your redirect URL:

https://[tenant_name].prod.authenticinsurance.com/apply?prefill_data=[payload]

The data parameter should be base64 encoded JSON with the following types in the following format:

{
    lead?: {
      email?: string;
      businessClassCode?: string;
      stateCodes?: string[];
      productIds?: string[];
    }
    responses?: {
      exposures?: Array<{
        id: string;
        exposureName: string;
        fieldValues: Record<string, string>;
      }>;
      questions?: Record<string, string>;
    }
  }

For reference here is a tool to convert between JSON and base64 encoding: https://codebeautify.org/json-to-base64-converter

  {
    lead: {
      email: "lfrank@authenticins.com",
      stateCodes: ["OH", "WY"],
      businessClassCode: "20831"
    },
    responses: {
      exposures: [{
        id: "1",
        exposureName: "business_location",
        fieldValues: {
          "ADDRESS": "100 street, UNIT 2, city, OH 33333, US",
          "SALES": "100000",
          "AREA": "2000"
        }
      }],
      questions: {
        "BUSINESS_LEGAL_NAME": "Authy Insurance Services, Inc.",
        "NAME": "Liam Frank",
        "PHONE": "2014206735",
        "MAILING_ADDRESS": "200 street, UNIT 5, Dayton, OH 33333, US"
      }
    }
  }

Which, encoded would look like this:

ewogICAgbGVhZDogewogICAgICBlbWFpbDogImxmcmFua0BhdXRoZW50aWNpbnMuY29tIiwKICAgICAgc3RhdGVDb2RlczogWyJPSCIsICJXWSJdLAogICAgICBidXNpbmVzc0NsYXNzQ29kZTogIjIwODMxIgogICAgfSwKICAgIHJlc3BvbnNlczogewogICAgICBleHBvc3VyZXM6IFt7CiAgICAgICAgaWQ6ICIxIiwKICAgICAgICBleHBvc3VyZU5hbWU6ICJidXNpbmVzc19sb2NhdGlvbiIsCiAgICAgICAgZmllbGRWYWx1ZXM6IHsKICAgICAgICAgICJBRERSRVNTIjogIjEwMCBzdHJlZXQsIFVOSVQgMiwgY2l0eSwgT0ggMzMzMzMsIFVTIiwKICAgICAgICAgICJTQUxFUyI6ICIxMDAwMDAiLAogICAgICAgICAgIkFSRUEiOiAiMjAwMCIKICAgICAgICB9CiAgICAgIH1dLAogICAgICBxdWVzdGlvbnM6IHsKICAgICAgICAiQlVTSU5FU1NfTEVHQUxfTkFNRSI6ICJBdXRoeSBJbnN1cmFuY2UgU2VydmljZXMsIEluYy4iLAogICAgICAgICJOQU1FIjogIkxpYW0gRnJhbmsiLAogICAgICAgICJQSE9ORSI6ICIyMDE0MjA2NzM1IiwKICAgICAgICAiTUFJTElOR19BRERSRVNTIjogIjIwMCBzdHJlZXQsIFVOSVQgNSwgRGF5dG9uLCBPSCAzMzMzMywgVVMiCiAgICAgIH0KICAgIH0KICB9

would then pass via the pre-fill data parameter as:

https://[tenant_name].prod.authenticinsurance.com/apply?prefill_data=ewogICAgbGVhZDogewogICAgICBlbWFpbDogImxmcmFua0BhdXRoZW50aWNpbnMuY29tIiwKICAgICAgc3RhdGVDb2RlczogWyJPSCIsICJXWSJdLAogICAgICBidXNpbmVzc0NsYXNzQ29kZTogIjIwODMxIgogICAgfSwKICAgIHJlc3BvbnNlczogewogICAgICBleHBvc3VyZXM6IFt7CiAgICAgICAgaWQ6ICIxIiwKICAgICAgICBleHBvc3VyZU5hbWU6ICJidXNpbmVzc19sb2NhdGlvbiIsCiAgICAgICAgZmllbGRWYWx1ZXM6IHsKICAgICAgICAgICJBRERSRVNTIjogIjEwMCBzdHJlZXQsIFVOSVQgMiwgY2l0eSwgT0ggMzMzMzMsIFVTIiwKICAgICAgICAgICJTQUxFUyI6ICIxMDAwMDAiLAogICAgICAgICAgIkFSRUEiOiAiMjAwMCIKICAgICAgICB9CiAgICAgIH1dLAogICAgICBxdWVzdGlvbnM6IHsKICAgICAgICAiQlVTSU5FU1NfTEVHQUxfTkFNRSI6ICJBdXRoeSBJbnN1cmFuY2UgU2VydmljZXMsIEluYy4iLAogICAgICAgICJOQU1FIjogIkxpYW0gRnJhbmsiLAogICAgICAgICJQSE9ORSI6ICIyMDE0MjA2NzM1IiwKICAgICAgICAiTUFJTElOR19BRERSRVNTIjogIjIwMCBzdHJlZXQsIFVOSVQgNSwgRGF5dG9uLCBPSCAzMzMzMywgVVMiCiAgICAgIH0KICAgIH0KICB9

Commonly Prefilled Questions

Field

Type

Example

Description

Field

Type

Example

Description

Policy Fields

Exposure Fields (Business Locations per Operation)

For any assistance or inquiries regarding data integration, please feel free to contact Zeke at zeke@authenticins.com or SK at saravsak@authenticins.com. They will be happy to help you out!

SMB Class Codes

Each SMB has an associated class code that we use to categorize the business to calculate the premium and help underwrite the risk

Class codes Authentic accepts:

CLASS_DESCRIPTION

CLASS_CODE

MARKET_GROUP_LONG

Data Capture (Easy Webhook Set Up)

How we help you set up event data retrieval

Using webhooks, partners can send event data from our app to themselves. We have set up 7 data events for partners to use, and can field requests to make other events available. Partners can tie any combination of events to an endpoint.

Data events

funnel.start - customer visited the portal
funnel.lead_accepted - an application was generated for the customer. Email has been collected
funnel.lead_rejected - an application was generated and rejected for the customer. Email has been collected
funnel.quote_generated - at least one product was accepted for a quote
funnel.quote_declined - all products customer selected were declined when generating a quote
funnel.checkout - customer clicked "pay" and was prompted to input their payment information
funnel.bind - customer purchased a policy

Set up

Request us to create a consumer application for you via Slack or email
Access the consumer portal using the link and authentication information we will send you.
Navigate to "<> Endpoints" on the left sidebar if you are not there already. Click "+ Add Endpoint".
1. For a refresher of data events, once on the "<> Endpoints" page you can click "Event Catalog" in the middle of the page.
Fill out all relevant fields:
1. Endpoint URL - enter the endpoint you will be sending information to
2. Description - (optional)
3. Subscribe to events - check off all data events you want this endpoint to receive
4. Advanced Configuration - (optional)
Click "Create"
Read Svix docs on how to receive and verify events https://docs.svix.com/receiving/introduction

Data Capture (Easy Webhook Set Up)

How we help you set up event data retrieval

Data events

funnel.start - customer visited the portal
funnel.lead_accepted - an application was generated for the customer. Email has been collected
funnel.lead_rejected - an application was generated and rejected for the customer. Email has been collected
funnel.quote_generated - at least one product was accepted for a quote
funnel.quote_declined - all products customer selected were declined when generating a quote
funnel.checkout - customer clicked "pay" and was prompted to input their payment information
funnel.bind - customer purchased a policy

Set up

Request us to create a consumer application for you via Slack or email
Access the consumer portal using the link and authentication information we will send you.
Navigate to "<> Endpoints" on the left sidebar if you are not there already. Click "+ Add Endpoint".
1. For a refresher of data events, once on the "<> Endpoints" page you can click "Event Catalog" in the middle of the page.
Fill out all relevant fields:
1. Endpoint URL - enter the endpoint you will be sending information to
2. Description - (optional)
3. Subscribe to events - check off all data events you want this endpoint to receive
4. Advanced Configuration - (optional)
Click "Create"
Read Svix docs on how to receive and verify events https://docs.svix.com/receiving/introduction

Data Sharing via URL

Here is a guide to pre-filling authentic application question fields through the URL

Forwarding data to your Authentic application flow is as simple as attaching one search parameter to your redirect URL:

https://[tenant_name].prod.authenticinsurance.com/apply?prefill_data=[payload]

The data parameter should be base64 encoded JSON with the following types in the following format:

{
    lead?: {
      email?: string;
      businessClassCode?: string;
      stateCodes?: string[];
      productIds?: string[];
    }
    responses?: {
      exposures?: Array<{
        id: string;
        exposureName: string;
        fieldValues: Record<string, string>;
      }>;
      questions?: Record<string, string>;
    }
  }

For reference here is a tool to convert between JSON and base64 encoding: https://codebeautify.org/json-to-base64-converter

  {
    lead: {
      email: "lfrank@authenticins.com",
      stateCodes: ["OH", "WY"],
      businessClassCode: "20831"
    },
    responses: {
      exposures: [{
        id: "1",
        exposureName: "business_location",
        fieldValues: {
          "ADDRESS": "100 street, UNIT 2, city, OH 33333, US",
          "SALES": "100000",
          "AREA": "2000"
        }
      }],
      questions: {
        "BUSINESS_LEGAL_NAME": "Authy Insurance Services, Inc.",
        "NAME": "Liam Frank",
        "PHONE": "2014206735",
        "MAILING_ADDRESS": "200 street, UNIT 5, Dayton, OH 33333, US"
      }
    }
  }

Which, encoded would look like this:

ewogICAgbGVhZDogewogICAgICBlbWFpbDogImxmcmFua0BhdXRoZW50aWNpbnMuY29tIiwKICAgICAgc3RhdGVDb2RlczogWyJPSCIsICJXWSJdLAogICAgICBidXNpbmVzc0NsYXNzQ29kZTogIjIwODMxIgogICAgfSwKICAgIHJlc3BvbnNlczogewogICAgICBleHBvc3VyZXM6IFt7CiAgICAgICAgaWQ6ICIxIiwKICAgICAgICBleHBvc3VyZU5hbWU6ICJidXNpbmVzc19sb2NhdGlvbiIsCiAgICAgICAgZmllbGRWYWx1ZXM6IHsKICAgICAgICAgICJBRERSRVNTIjogIjEwMCBzdHJlZXQsIFVOSVQgMiwgY2l0eSwgT0ggMzMzMzMsIFVTIiwKICAgICAgICAgICJTQUxFUyI6ICIxMDAwMDAiLAogICAgICAgICAgIkFSRUEiOiAiMjAwMCIKICAgICAgICB9CiAgICAgIH1dLAogICAgICBxdWVzdGlvbnM6IHsKICAgICAgICAiQlVTSU5FU1NfTEVHQUxfTkFNRSI6ICJBdXRoeSBJbnN1cmFuY2UgU2VydmljZXMsIEluYy4iLAogICAgICAgICJOQU1FIjogIkxpYW0gRnJhbmsiLAogICAgICAgICJQSE9ORSI6ICIyMDE0MjA2NzM1IiwKICAgICAgICAiTUFJTElOR19BRERSRVNTIjogIjIwMCBzdHJlZXQsIFVOSVQgNSwgRGF5dG9uLCBPSCAzMzMzMywgVVMiCiAgICAgIH0KICAgIH0KICB9

would then pass via the pre-fill data parameter as:

https://[tenant_name].prod.authenticinsurance.com/apply?prefill_data=ewogICAgbGVhZDogewogICAgICBlbWFpbDogImxmcmFua0BhdXRoZW50aWNpbnMuY29tIiwKICAgICAgc3RhdGVDb2RlczogWyJPSCIsICJXWSJdLAogICAgICBidXNpbmVzc0NsYXNzQ29kZTogIjIwODMxIgogICAgfSwKICAgIHJlc3BvbnNlczogewogICAgICBleHBvc3VyZXM6IFt7CiAgICAgICAgaWQ6ICIxIiwKICAgICAgICBleHBvc3VyZU5hbWU6ICJidXNpbmVzc19sb2NhdGlvbiIsCiAgICAgICAgZmllbGRWYWx1ZXM6IHsKICAgICAgICAgICJBRERSRVNTIjogIjEwMCBzdHJlZXQsIFVOSVQgMiwgY2l0eSwgT0ggMzMzMzMsIFVTIiwKICAgICAgICAgICJTQUxFUyI6ICIxMDAwMDAiLAogICAgICAgICAgIkFSRUEiOiAiMjAwMCIKICAgICAgICB9CiAgICAgIH1dLAogICAgICBxdWVzdGlvbnM6IHsKICAgICAgICAiQlVTSU5FU1NfTEVHQUxfTkFNRSI6ICJBdXRoeSBJbnN1cmFuY2UgU2VydmljZXMsIEluYy4iLAogICAgICAgICJOQU1FIjogIkxpYW0gRnJhbmsiLAogICAgICAgICJQSE9ORSI6ICIyMDE0MjA2NzM1IiwKICAgICAgICAiTUFJTElOR19BRERSRVNTIjogIjIwMCBzdHJlZXQsIFVOSVQgNSwgRGF5dG9uLCBPSCAzMzMzMywgVVMiCiAgICAgIH0KICAgIH0KICB9

Data Share

Authentic Application

Benefits of Pre-filling:

Every application has three distinct parts:

Getting started with prefilling data

Data Sharing via Widget

Data Sharing via URL

Commonly Prefilled Questions

Fields for Widget Integration

Lead Fields (minimum recommended fields for data sharing)

Policy Fields

Exposure Fields (Business Locations per Operation)

SMB Class Codes

Class codes Authentic accepts:

Data Capture (Easy Webhook Set Up)

Data events

Set up

Data Share

Authentic Application

Benefits of Pre-filling:

Every application has three distinct parts:

Getting started with prefilling data

Data Sharing via Widget

Data Capture (Easy Webhook Set Up)

Data events

Set up

Data Sharing via URL

SMB Class Codes

Class codes Authentic accepts:

Commonly Prefilled Questions

Fields for Widget Integration

Lead Fields (minimum recommended fields for data sharing)

Policy Fields

Exposure Fields (Business Locations per Operation)