Reduce friction and latency for long-running jobs with Webhooks in Gemini API

Google AI Blog Tools

Summary

Google introduces event-driven Webhooks for the Gemini API to reduce latency and friction for long-running jobs like Deep Research and batch processing. This feature replaces inefficient polling with push-based notifications, improving developer experience for agentic applications.

<img src="https://storage.googleapis.com/gweb-uniblog-publish-prod/images/WebhooksGeminiAPI-hero.max-600x600.format-webp.webp">Event-Driven Webhooks are a push-based notification system that eliminates the need for inefficient polling.
Original Article
View Cached Full Text

Cached at: 05/08/26, 07:42 AM

# Reduce friction and latency for long-running jobs with Webhooks in Gemini API Source: [https://blog.google/innovation-and-ai/technology/developers-tools/event-driven-webhooks/](https://blog.google/innovation-and-ai/technology/developers-tools/event-driven-webhooks/) We're making it easier and more efficient to build complex, long\-running agentic applications with the Gemini API Webhooks\. Hussein Hassan Harrirou Engineering, Gemini API ![Gemini API](https://storage.googleapis.com/gweb-uniblog-publish-prod/images/WebhooksGeminiAPI-hero.width-200.format-webp.webp) Your browser does not support the audio element\. Listen to article This content is generated by Google AI\. Generative AI is experimental \[\[duration\]\] minutes Today, we're making it easier and more efficient to build complex, long\-running agentic applications with the Gemini API\. We are introducing event\-driven Webhooks, a push\-based notification system that eliminates the need for inefficient polling\. As Gemini shifts toward agentic workflows and high\-volume processing — like Deep Research, long video generation, or processing thousands of prompts via the Batch API — operations can take minutes or even hours\. Until now, developers had to rely on continuous polling \(e\.g\., repeatedly calling`GET`operations\) to check if a job was completed\. Now, the Gemini API can simply push a real\-time HTTP POST payload to your server the instant a task finishes\. We’ve built this with reliability and security in mind\. Our implementation strictly adheres to the[Standard Webhooks](https://github.com/standard-webhooks/standard-webhooks)specification\. Every request is signed using`webhook\-signature`,`webhook\-id`, and`webhook\-timestamp`headers, ensuring idempotency and preventing replay attacks\. We also guarantee "at\-least\-once" delivery with automatic retries for up to 24 hours\. ## How it works You can configure webhooks globally at the project level \(secured via HMAC\), or override them dynamically on a per\-request basis to route specific jobs \(secured via JWKS\)\. Here's a quick example of how you can dynamically configure a webhook for a batch task using the Python SDK: ## Get started today This feature is available now for all developers using the Gemini API: - **Read the guide:**Check out the[Webhooks documentation](https://ai.google.dev/gemini-api/docs/webhooks)to explore the full event catalog and learn how to secure your endpoints\. - **Hands\-on practice:**We've prepared a comprehensive[Cookbook](https://github.com/google-gemini/cookbook/blob/main/quickstarts/Webhooks.ipynb)to help you build an end\-to\-end integration with webhooks\.

Similar Articles

New ways to balance cost and reliability in the Gemini API

Google AI Blog

Google introduces Flex and Priority inference tiers for the Gemini API, offering developers granular control over cost and reliability for synchronous requests. Flex provides 50% savings for latency-tolerant tasks, while Priority ensures high reliability for critical applications.

Gemini API Managed Agents: 3.6 Flash, hooks, and more

Google AI Blog

Google announced updates to Managed Agents in the Gemini API, including a default to the Gemini 3.6 Flash model, environment hooks for tool call auditing, budget controls, scheduled triggers, and free tier access.