Google Integration

Gmail ──push──▶ Google Pub/Sub ──HTTP POST──▶ apowerb
                  (topic)                          /api/webhooks/gmail/notifications
                                                        │
                                                        ▼
                                                  fetch new mail via the Gmail API
                                                        │
                                                        ▼
                                                  run the associated agent

Prerequisites

A Google Cloud project with billing enabled
Gmail API, Google Drive API, and Cloud Pub/Sub API enabled
A publicly reachable HTTPS URL

Register an Application

To establish the connection, you first need to set up an OAuth application in the Google Cloud Console:

Configure OAuth Consent Screen

Go to APIs & Services > OAuth consent screen. Select External (or Internal), fill in required fields, and add the scopes needed:

Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.send
Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file

Create Credentials

Go to APIs & Services > Credentials > Create Credentials > OAuth client ID.

Type: Web application
Name: apowerb-integration
Authorized redirect URIs: https://your-domain.com/api/v1/auth/callback

Save Credentials

Download the JSON credentials or copy the Client ID and Client Secret.

Infrastructure Setup

Enable the APIs

gcloud services enable gmail.googleapis.com drive.googleapis.com pubsub.googleapis.com \
  --project=YOUR_PROJECT_ID

Create the topic

gcloud pubsub topics create gmail-notifications \
  --project=YOUR_PROJECT_ID

Permissions

gcloud pubsub topics add-iam-policy-binding gmail-notifications \
  --project=YOUR_PROJECT_ID \
  --member="serviceAccount:gmail-api-push@system.gserviceaccount.com" \
  --role="roles/pubsub.publisher"

Create the push subscription

gcloud pubsub subscriptions create gmail-notifications-push \
  --topic=gmail-notifications \
  --push-endpoint=https://YOUR_DOMAIN/api/webhooks/gmail/notifications \
  --project=YOUR_PROJECT_ID

Setup

Configure the environment

Set the following GOOGLE_INTEGRATION_* variables in your environment:

GOOGLE_INTEGRATION_CLIENT_ID: Your Client ID
GOOGLE_INTEGRATION_CLIENT_SECRET: Your Client Secret
GMAIL_PUBSUB_PROJECT_ID: Your GCP project ID
GMAIL_PUBSUB_TOPIC: gmail-notifications

Connect services

From the interface, navigate to Integrations and select Google. Connect your account using the configured credentials.

Subscribe to notifications

curl -X POST https://YOUR_DOMAIN/api/webhooks/subscriptions \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "provider": "google_gmail",
    "resource": "INBOX",
    "agent_id": "AGENT_ID",
    "change_type": "created"
  }'

Get started

Concepts

Business Agents

Frontend

Automation

AgentOps

Integrations

Tools & Skills

Ecosystem

Contributing

Prerequisites

Register an Application

Infrastructure Setup

Setup

​Prerequisites

​Register an Application

​Infrastructure Setup

​Setup

Prerequisites

Register an Application

Infrastructure Setup

Setup