> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Gemini Webhook Setup Guide

> Configure Google Gemini to deliver events to StackOne.

## Prerequisites

The connector should already be set up, with a Connector Profile and a Linked Account. See [Getting Started](/connectors/googlegemini#getting-started) on the Google Gemini connector page.

<section data-guide-section data-guide-scopes="">
  <h2>How webhook setup works</h2>

  <p>StackOne creates and manages the Google Gemini webhook subscription automatically when the account is connected, and removes it when the account is disconnected. There is no URL to copy and nothing to configure in Google.</p>

  <Steps>
    <Step title="Enable the events you want">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the StackOne dashboard, open the Google Gemini connector profile and enable the webhook events you want delivered. StackOne registers a single project-level subscription covering exactly those events. Changing the selection re-registers the subscription.</p>
      </div>
    </Step>

    <Step title="Review what the subscription covers">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>A Google Gemini webhook is scoped to the Google Cloud project behind the connected credential, so one linked account maps to one subscription. Events are generated by asynchronous work in that project — batch jobs, background interactions, and Veo video generation. Accounts that only make synchronous requests will never receive an event.</p>

        <ul>
          <li>The subscription is created with the same API key or OAuth credential used by the rest of the connector. No extra permissions are needed.</li>
          <li>Google signs each delivery with its own signing secret, issued when the subscription is created.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Available webhook events</h2>

  <p>The following Google Gemini events can be enabled. Only events selected in StackOne are included in the subscription — Google will not deliver events that are not subscribed.</p>

  <Steps>
    <Step title="Enable batch events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to the lifecycle of asynchronous batch jobs.</p>

        <ul>
          <li><strong>Batch Succeeded</strong> (`batch.succeeded`) — Fired when a batch job finishes processing successfully and its results file is ready</li>
          <li><strong>Batch Failed</strong> (`batch.failed`) — Fired when a batch job terminates with a system or validation error</li>
          <li><strong>Batch Expired</strong> (`batch.expired`) — Fired when a batch job is not processed within its 24-hour window and is discarded</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable interaction events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to long-running interactions submitted with background processing.</p>

        <ul>
          <li><strong>Interaction Completed</strong> (`interaction.completed`) — Fired when a background interaction finishes successfully</li>
          <li><strong>Interaction Failed</strong> (`interaction.failed`) — Fired when a background interaction terminates with an error</li>
          <li><strong>Interaction Requires Action</strong> (`interaction.requires_action`) — Fired when an interaction pauses and waits for a function call result to be supplied</li>
        </ul>
      </div>
    </Step>

    <Step title="Enable video events">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Events related to Veo video generation.</p>

        <ul>
          <li><strong>Video Generated</strong> (`video.generated`) — Fired when a Veo video generation job finishes and the output file is ready to download</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Verify

Your Connector should now be able to receive and process events. Try triggering an event and you should see an Event appear in the Connector logs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.