Webhooks and Events

ZoomInfo webhooks notify your application when long-running jobs complete, records change, credit thresholds are reached, or new GTM signals become available. Those are available via our Agents API.

Use webhooks when your application should react to changes without polling.

Example Use Cases

• Start a downstream workflow when a bulk enrichment job completes.
• Notify RevOps when an account enters a high-intent segment.
• Send an alert when credit usage crosses an admin-defined threshold.
• Refresh CRM records when enriched data changes.
• Trigger a campaign when a new scoop or funding event is detected.

Create a Webhook Subscription

post https://api.zoominfo.com/gtm/agent/v1/agent-teams/{agentTeamId}/runs

Triggers an Agent Team run. Any Agent Team can be run manually using this endpoint, even if the Agent Team is marked with inactive.

Agent Teams run asynchronously, so this endpoint returns the Agent Team run with the id created and the initial run status. Poll Get Agent Team Results to get status updates on the Agent Team run.

https://docs.zoominfo.com/reference/agentteamscontroller_runagentteam

Event Payload

Get Agent Team Results get https://api.zoominfo.com/gtm/agent/v1/agent-teams/{agentTeamId}/runs/{runId}

Retrieves the current status and available output for a previously started Agent Team run.

Poll this endpoint after executing an Agent Team run to check the status of that Agent Team. Returns 404 when the Agent Team or run does not exist, or if the run does not belong to the specified Agent Team.

Get Agent Team Details get https://api.zoominfo.com/gtm/agent/v1/agent-teams/{agentTeamId}

Fetch an Agent Team by id, returning the full Agent Team details. The Agent Team details include configured input parameters that are required when executing an Agent Team using the Run Agent Team endpoint.

Use List Agent Teams to find an Agent Team if you don't already know the identifier you are looking to get details for.

Retry Behavior

Retries, Frequencies, Throttling can be configured in the Agent Team details by event type, object type and run.

Agent Guidance

Agents should prefer webhooks over polling for long-running workflows.

MCP

For AI agents and MCP-compatible clients, use:

https://mcp.zoominfo.com/mcp

See Agent Integration with ZoomInfo MCP: https://docs.zoominfo.com/docs/zi-api-mcp-overview

CLI Planned / Waitlist

Install:

npm install -g @zoominfo/gtm-cli

Run a search:

zi companies search \
  --industry "Computer Software" \
  --employees 200-1000 \
  --location "United States" \
  --technology "Salesforce"

Run an agent-ready GTM job:

zi run build-tam \
  "Fintech companies with 1,000+ employees showing fraud-detection intent" \
  --personas "Risk, Engineering, Compliance" \
  --limit 50