PredictHQ logo

Integrate PredictHQ with your AI CRM

PredictHQ provides event intelligence, demand forecasting, and location analytics APIs for anticipating changes in demand.

Explore Triggers and Actions

Calculate Event Features

Calculate one page of daily or weekly ML-ready event features for a required date range using either a Beam analysis or a manually configured location and feature set.

ActionTry it

Count Broadcasts

Return the total number of PredictHQ broadcast records matching optional broadcast, schedule, date, viewership, location, and event filters, without returning result records.

ActionTry it

Count Events

Get aggregate event counts by category, label, rank level, and the same date, location, rank, attendance, spend, and event filters supported by search.

ActionTry it

Create Beam Analysis

Create a Beam analysis that correlates an owned location's events with uploaded demand data.

ActionTry it

Create Beam Analysis Group

Create a Beam analysis group that aggregates feature importance across compatible analyses.

ActionTry it

Create Forecast Model

Create a forecast model for a Saved Location. After creation, upload historical demand data and trigger model training with the corresponding Forecasts actions.

ActionTry it

Create Loop Link

Create a hosted Loop link for end users to submit missing events or event feedback, and return both shareable URLs. An empty body creates a default-named active link.

ActionTry it

Create Saved Location

Create a reusable PredictHQ Saved Location from an exact business point, a custom GeoJSON area, or Geonames place IDs.

ActionTry it

Create Saved Location Closure

Create a closure period for a PredictHQ Saved Location. The date range must not overlap an existing closure for the location.

ActionTry it

Create Saved Location Opening Hours

Create opening hours for a Saved Location. The effective date range must not overlap another opening-hours record for the same location.

ActionTry it

Delete Beam Analysis

Soft-delete a Beam Analysis. The analysis remains retrievable when filtering for deleted analyses, and containing Analysis Groups are refreshed automatically.

ActionTry it

Delete Beam Analysis Group

Delete an existing Beam Analysis Group without deleting the individual analyses in the group.

ActionTry it

Delete Forecast Model

Permanently deletes a forecast model and all associated demand data and forecasts. The model must not be in `preparing`, `training`, or `forecasting` status. This action is irreversible.

ActionTry it

Delete Loop Link

Soft-delete a Loop link. The record remains retrievable with `status=deleted`.

ActionTry it

Delete Saved Location

Permanently delete a Saved Location and all of its associated insights data. This action is irreversible.

ActionTry it

Delete Saved Location Closure

Delete a closure by ID from the specified PredictHQ Saved Location. This action is irreversible.

ActionTry it

Delete Saved Location Opening Hours

Delete an opening hours record by ID from the specified PredictHQ Saved Location. This action is irreversible.

ActionTry it

Get Beam Analysis

Return the full details of one Beam Analysis, including its location, demand type, rank, readiness status, and processing state.

ActionTry it

Get Beam Analysis Feature Importance

Return the Beam feature groups whose statistical significance indicates how strongly they affect an analysis's demand, including the Features API fields recommended for forecasting models.

ActionTry it

Get Beam Analysis Group

Return the full details of one Beam Analysis Group, including its member analyses, demand type, readiness status, and processing state.

ActionTry it

Get Beam Analysis Group Feature Importance

Return feature-importance results aggregated across the analyses in an existing Beam Analysis Group, including each feature group's Features API fields and p-value.

ActionTry it

Get Demand Surges

Return dates with at least the requested demand-surge intensity for a required date and location, including summed predicted attendance.

ActionTry it

Get Forecast Model

Retrieves a forecast model by ID, including its readiness status, configuration, accuracy metrics, and location details.

ActionTry it

Get Loop Link

Return one Loop Link, including its status, metadata, expiry, and hosted event-submission and event-feedback URLs.

ActionTry it

Get Loop Settings

Return the organization name displayed in the hosted Loop interface.

ActionTry it

Get Predicted Impact Area

Calculate a polygonal or radial Predicted Impact Area for a business location and industry, returned as GeoJSON.

ActionTry it

Get Saved Location

Retrieve a Saved Location by ID, including its geometry, enrichment status, labels, resolved places, summary insights, opening hours, and closures.

ActionTry it

Get Saved Location Closure

Return a single closure by ID for the specified Saved Location.

ActionTry it

Get Saved Location Opening Hours

Return one opening hours record by its ID for a specified PredictHQ Saved Location.

ActionTry it

List Beam Analyses

Return one page of Beam Analyses, with filters for lifecycle state, readiness, groups, demand type, location, labels, update date, and name.

ActionTry it

List Beam Analysis Correlation Results

Return one page of results correlating PredictHQ event data with an analysis's transactional demand data for a required lower and upper date bound.

ActionTry it

List Beam Analysis Groups

Return one page of Beam Analysis Groups, optionally filtered by update date, name, lifecycle state, readiness, demand interval, or industry.

ActionTry it

List Forecast Algorithms

Returns the list of available forecasting algorithms. Currently one algorithm is offered (`phq-xgboost`) based on XGBoost.

ActionTry it

List Forecast Model Demand

Return one page of demand data uploaded to a forecast model, optionally filtered by date, as JSON, CSV, or newline-delimited JSON.

ActionTry it

List Forecast Models

Return one page of forecast models belonging to the authenticated organization, optionally filtered by text, Saved Location, or readiness status.

ActionTry it

List Loop Event Submissions

Return one page of Loop-submitted events matching link, event, user, review, state, category, location, and date filters.

ActionTry it

List Loop Feedback Conversations

Return one page of Loop feedback conversations matching record, link, user, feedback type, status, text, and date filters.

ActionTry it

List Loop Links

Return one page of hosted Loop links matching text, link, user, and sort filters.

ActionTry it

List Model Forecast Results

Return one page of generated forecast results for a trained model, optionally filtered by date and enriched with features or event explainability.

ActionTry it

List Place Hierarchies

Return one page of administrative hierarchy chains resolved from either place IDs or coordinates.

ActionTry it

List Saved Location Closures

Return one page of closure records for a PredictHQ Saved Location, optionally filtered by the dates on which the records are active.

ActionTry it

List Saved Location Insight Events

Return one page of events that impact a specified PredictHQ Saved Location.

ActionTry it

List Saved Location Opening Hours

Return one page of opening-hours records for a Saved Location, optionally filtered by the dates on which the records are active.

ActionTry it

List Saved Locations

Search and return one page of Saved Locations, including reusable location IDs, geographic definitions, enrichment state, and summary insights.

ActionTry it

Refresh Beam Analysis

Rerun correlation and analysis processing for an existing Beam Analysis. The analysis readiness status becomes pending until processing completes; the request fails if the analysis is already being processed.

ActionTry it

Refresh Beam Analysis Group

Rerun aggregation for an existing Beam Analysis Group. The group's readiness status becomes pending until processing completes; the request fails if the group is already being processed.

ActionTry it

Replace Beam Analysis

Fully replace an existing Beam analysis using PUT. Retrieve the current analysis first and include every value that must be preserved; omitted optional fields may be lost. Use the partial-update action for PATCH semantics.

ActionTry it

Replace Beam Analysis Group

Fully replace an existing Beam analysis group using PUT. Retrieve the current group first and include all values that must be preserved; use the partial-update action when omitted fields should remain unchanged.

ActionTry it

Replace Forecast Model

Fully replace an existing forecast model's mutable configuration. This is the PUT replacement operation, not the partial PATCH update. Configuration changes may make the model stale and require retraining, and are blocked while it is preparing, training, or forecasting.

ActionTry it

Replace Loop Link

Fully replace the mutable name, expiry, and metadata of an existing PredictHQ Loop Link using PUT.

ActionTry it

Replace Saved Location

Fully replace an existing PredictHQ Saved Location using PUT. Include every value that must be preserved. To recalculate its Predicted Impact Area, provide origin_geojson without geojson or place_ids.

ActionTry it

Replace Saved Location Opening Hours

Fully replace one PredictHQ Saved Location opening-hours record. This PUT operation replaces the complete record and rejects date ranges that overlap another opening-hours record for the location.

ActionTry it

Search Broadcasts

Return one page of US county-level live-TV broadcast records matching event, geography, status, and date filters.

ActionTry it

Search Events

Search for events happening in a location and date range using PredictHQ's event, location, rank, label, attendance, spend, and lifecycle filters. Returns one page and a continuation cursor.

ActionTry it

Search Places

Return one page of places matching text, country, coordinates, place IDs, or administrative type filters.

ActionTry it

Train Forecast Model

Triggers asynchronous training for a forecast model that has uploaded demand data and is in an eligible readiness state. Poll the model's `readiness.status` field to monitor progress.

ActionTry it

Update Beam Analysis

Partially update one or more fields on an existing Beam analysis without replacing fields that are omitted.

ActionTry it

Update Beam Analysis Group

Partially update an existing Beam analysis group using PATCH. Only fields provided in the request are changed; use the replacement action to replace all fields.

ActionTry it

Update Forecast Model

Partially update a forecast model. Changes to location, demand type, forecast window, algorithm, or baseline generation are blocked while the model is preparing, training, or forecasting, and otherwise make it stale until it is retrained.

ActionTry it

Upload Beam Analysis Demand

Upload daily or weekly demand data to an existing Beam analysis. New values replace existing values for matching dates, and individual dates cannot be removed. The complete stored series must remain valid after each upload.

ActionTry it

Upload Forecast Model Demand

Upload historical demand data to an existing forecast model as typed JSON, CSV, or newline-delimited JSON. The upload changes the model's training data and requires paid Forecasts access.

ActionTry it

Upsert Loop Settings

Create or replace the organization-wide display name used by the hosted Loop interface. WARNING: this changes the Loop UI for the entire organization. Read and save the current settings first, obtain explicit approval, and have an unconditional restoration plan before calling.

ActionTry it

How the PredictHQ integration works

The PredictHQ integration connects your Dench AI CRM directly to PredictHQ, so agents can read and act on your PredictHQ data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.

62 actions are available for agents to invoke on your behalf. Every call runs through PredictHQ's own authorization, scoped to the account you connect.

Set up PredictHQ in Dench

  1. 1

    Sign in to your Dench workspace and open Integrations.

  2. 2

    Find PredictHQ and click Connect — you'll authorize access through PredictHQ's own sign-in flow. No API keys or code required.

  3. 3

    Ask an agent to use PredictHQ in chat, or call it from an automation.

  4. 4

    Manage or disconnect the connection any time from workspace settings.

Frequently asked questions

How does the PredictHQ integration work with Dench?

The Dench PredictHQ integration connects your AI CRM to PredictHQ, so AI agents can work with your PredictHQ data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.

What actions can AI agents perform with PredictHQ via Dench?

The PredictHQ integration currently exposes 62 actions, including Calculate Event Features, Count Broadcasts, Count Events, Create Beam Analysis, Create Beam Analysis Group, and Create Forecast Model. Agents invoke them on your behalf from chat or from automations.

Do I need to write code to connect PredictHQ to Dench?

No. You connect PredictHQ from your Dench workspace using PredictHQ's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.

Is the PredictHQ integration secure?

Connections are authorized through PredictHQ's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the PredictHQ connection from your workspace settings at any time.