Obtaining Checklist data using Zapier

There is no specific dropdown action in Zapier for checklist information, so this guide covers how to use the “API Request (Beta)” action to make an API call to the checklist feature within your HOVER account.

What information from Hover's checklist products is accessible via Zapier?

Checklists can be generated before photos are submitted for a Hover capture. Checklist data can be pulled from any trigger event in your HOVER account. The earliest event available in the workflow of any given Hover account is the “job updated” event, which makes it an efficient event to trigger pulling the checklist on. For this guides example, we will use "job updated" as our example trigger event.

Calling the Checklist API

To call the checklist API, set the HTTP Method to “GET” and insert the checklist request URL “https://hover.to/api/inspection/checklists/latest” into the “URL” Field. Use your “org_id” and “job_id” as the “query string parameters” and apply the “Org Id” and “Job ID” data values as inputs to the corresponding data fields.

Below is an example of the type of checklist information available to pull from your Hover account when you use the “Job Updated in Hover” Zapier trigger and the “API Request (Beta) in Hover” Zapier action.”

Note: 🛑 This information becomes available only when you have completed a Checklist template in your authenticated Hover account. The following data is an example resulting from a specific template in a demo account. Templates can be customized to contain different sort orders, question types, and question text, so the resulting data in your response will be specific to the templates you have set up in your account.🛑

{
  "id": "de447d89-58f3-4770-84ec-3fd7cdc1164d",
  "job_id": 8381351,
  "questions": [
    {
      "id": "6c17dcc0-d25e-4473-9855-a0f46311e5f5",
      "sort_order": 0,
      "question_type": "string",
      "question_text": "Property owner's name?",
      "answer_value": "Jamie",
      "images": []
    },
    {
      "id": "708f8dd8-39a4-4bd8-9d66-82b1db557dd6",
      "sort_order": 0,
      "question_type": "select",
      "question_text": "How many layers are there?",
      "answer_value": "1",
      "images": []
    },
    {
      "id": "720330fe-4a1d-433f-ac6f-92a892c1d5c1",
      "sort_order": 0,
      "question_type": "select",
      "question_text": "Specify the type of ventilation",
      "answer_value": "Ridge vents",
      "images": []
    },
    {
      "id": "0bede2e9-5636-4c5f-b9fe-0b867129ca23",
      "sort_order": 0,
      "question_type": "boolean",
      "question_text": "Does the chimney need to be reflashed?",
      "answer_value": "",
      "images": []
    },
    {
      "id": "e3a94f10-a658-4fdb-a99a-ba5b8c7f5e85",
      "sort_order": 0,
      "question_type": "number",
      "question_text": "How many skylights are there?",
      "answer_value": "0",
      "images": []
    },
    {
      "id": "19507314-ff05-4ffa-bb59-5f672e40152e",
      "sort_order": 0,
      "question_type": "select",
      "question_text": "What size is the fascia?",
      "answer_value": "11.25\"",
      "images": []
    },
    {
      "id": "5734dba4-d02c-4744-a6f0-706971260c20",
      "sort_order": 0,
      "question_type": "string",
      "question_text": "Please add any additional notes and photos that will be necessary for the purpose of generating an estimate, material order, or installation.",
      "answer_value": "",
      "images": []
    },
    {
      "id": "fcdde9bd-347f-4426-ba52-4a1c3c292393",
      "sort_order": 1,
      "question_type": "string",
      "question_text": "Property owner's preferred contact method and info? Please specify email, text, or phone call.",
      "answer_value": "Phone",
      "images": []
    },
    {
      "id": "0bcf5b9c-f3e9-499c-8a2a-48adbf80da90",
      "sort_order": 1,
      "question_type": "select",
      "question_text": "Does the roof need to be redecked?",
      "answer_value": "Unsure",
      "images": []
    },
    {
      "id": "56630e94-6a07-4967-a4c2-6f20c78816b3",
      "sort_order": 1,
      "question_type": "number",
      "question_text": "How many pipe boots does the roof have?",
      "answer_value": "2",
      "images": []
    },
    {
      "id": "85b0896e-0e7a-433f-97b5-1c4c620d1089",
      "sort_order": 1,
      "question_type": "boolean",
      "question_text": "Is there additional roof-to-wall flashing",
      "answer_value": "",
      "images": []
    },
    {
      "id": "71036d22-ec61-4b25-a875-a9fbf929a963",
      "sort_order": 2,
      "question_type": "boolean",
      "question_text": "Is this report for an insurance claim?",
      "answer_value": "true",
      "images": []
    },
    {
      "id": "04385087-d631-4f2a-896d-f0b673ceb553",
      "sort_order": 2,
      "question_type": "boolean",
      "question_text": "Is there other existing damage? If yes, please provide photos.",
      "answer_value": "",
      "images": []
    },
    {
      "id": "f9aca966-8680-4d73-9c06-7abb54657c30",
      "sort_order": 2,
      "question_type": "string",
      "question_text": "What size are the vents (i.e 4\", 6\")",
      "answer_value": "6”",
      "images": []
    },
    {
      "id": "d8bf5293-4b3e-4f73-8e13-f24ace1ecd6b",
      "sort_order": 3,
      "question_type": "boolean",
      "question_text": "Is a permit required for this project?",
      "answer_value": "true",
      "images": []
    },
    {
      "id": "9dc2c3f9-8f85-42a7-bf60-f0cc1327952b",
      "sort_order": 3,
      "question_type": "select",
      "question_text": "What is the existing roofing material?",
      "answer_value": "Asphalt",
      "images": []
    },
    {
      "id": "a5cb74b9-1631-48ec-8862-490304eebe12",
      "sort_order": 3,
      "question_type": "number",
      "question_text": "How many kitchen vents?",
      "answer_value": "1",
      "images": []
    },
    {
      "id": "2a0304ca-c5cf-41fc-a8fb-b333abf53550",
      "sort_order": 4,
      "question_type": "number",
      "question_text": "How many stories does the structure have?",
      "answer_value": "2",
      "images": []
    },
    {
      "id": "b8a13418-9dda-467d-96ad-9b7712262174",
      "sort_order": 4,
      "question_type": "boolean",
      "question_text": "Is there flat roof?",
      "answer_value": "",
      "images": []
    },
    {
      "id": "94d2349b-0e5c-40fd-b631-d8e3abd1a8c8",
      "sort_order": 4,
      "question_type": "boolean",
      "question_text": "Will the kitchen vents require cutting in?",
      "answer_value": "",
      "images": []
    },
    {
      "id": "00630bfb-2453-49a2-bc12-65d28027c9d6",
      "sort_order": 5,
      "question_type": "boolean",
      "question_text": "Is the property accessible for a haul away and a material drop off? Please provide at least one photo.",
      "answer_value": "true",
      "images": [
        {
          "redirect_url": "http://ehi.hover.to/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBM3JaQlE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--c83cbf9ea17a7c86f59ad38ccfd95d4c8188e5d7/E7087F34-D414-451D-949A-DB156D41EEC8.jpg",
          "created_at": "2023-06-21T15:54:32.925Z"
        }
      ]
    },
    {
      "id": "690b0f13-99c0-4d2b-81c5-d76c85100069",
      "sort_order": 5,
      "question_type": "number",
      "question_text": "How many bathroom vents?",
      "answer_value": "0",
      "images": []
    },
    {
      "id": "ad2c1267-74a7-41cc-83db-8daf484537a8",
      "sort_order": 6,
      "question_type": "boolean",
      "question_text": "Will the bathroom vents require cutting in?",
      "answer_value": "",
      "images": []
    }
  ],
  "report_pdf": {
    "id": 381947,
    "name": "report_pdf",
    "record_id": "de447d89-58f3-4770-84ec-3fd7cdc1164d",
    "record_type": "Inspection::Checklist",
    "blob_id": 383375,
    "created_at": "2023-06-21T15:55:53.386Z",
    "pdf_url": "http://ehi.hover.to/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBBNC9aQlE9PSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--882688ace7df9e1e581fb22a02451289a759db21/8381351_checklist_report.pdf"
  }
}