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

# Gmail Integration

Streamline your blockchain operations by connecting Gmail to your automated workflows. Automatically trigger smart contract alerts, transaction notifica...

![Gmail logo](https://ai-icon.b3.fun/logo/gmail) Integration available

Streamline your blockchain operations by connecting Gmail to your automated workflows. Automatically trigger smart contract alerts, transaction notifications, or governance updates directly from your inbox to keep your crypto ecosystem running 24/7.


**[Public page](https://b3os.org/integrations/app/gmail)**

Open the user-facing integration overview for examples, templates, and sharing.
  **[Action reference](/actions/reference)**

Schema-level references for executable actions and test payloads.
  **[Trigger reference](/actions/trigger-reference)**

Event and schedule triggers that can start B3OS workflows.

## Build With Gmail

Use Gmail when a workflow needs to react to Gmail: New Email Matching Search, Gmail: New Email Received and follow up with actions such as Gmail: Create Draft, Gmail: Send Email. Start in the visual editor to connect an account, then use the references below for payload shape, required fields, and API testing.

## Available Actions

| Action | ID | Connector | Required fields |
| --- | --- | --- | --- |
| ![Gmail: Create Draft logo](https://ai-icon.b3.fun/logo/gmail) [Gmail: Create Draft](/actions/reference/generated/gmail-create-draft) | `gmail-create-draft` | ![pipedream:gmail logo](https://ai-icon.b3.fun/logo/gmail) `pipedream:gmail` | `to`, `subject`, `body` |
| ![Gmail: Send Email logo](https://ai-icon.b3.fun/logo/gmail) [Gmail: Send Email](/actions/reference/generated/gmail-send-email) | `gmail-send-email` | ![pipedream:gmail logo](https://ai-icon.b3.fun/logo/gmail) `pipedream:gmail` | `to`, `subject`, `body` |


## Available Triggers

| Trigger | ID | Required configuration |
| --- | --- | --- |
| [Gmail: New Email Matching Search](/actions/trigger-reference/triggers/gmail-new-email-matching-search) | `gmail-new-email-matching-search` | - |
| [Gmail: New Email Received](/actions/trigger-reference/triggers/gmail-new-email-received) | `gmail-new-email-received` | - |


## Common Use Cases

**Automated Governance Alerts**

Automatically trigger a workflow whenever a new governance proposal email is received, ensuring your team can vote on critical DAO decisions immediately.
  **Exchange Notification Workflows**

Monitor your inbox for withdrawal or deposit confirmations from crypto exchanges to trigger internal accounting or liquidity management tasks.
  **Security Alert Response**

Set up instant workflows that activate when security services send emails regarding suspicious activity or wallet vulnerabilities, reducing response time.
  **Smart Contract Event Logging**

Bridge the gap between email-based alerts from monitoring tools and your operational database by automatically logging incoming contract event notifications.

## Connector Notes

- Create the connector from a trusted B3OS organization before publishing workflows that call external accounts.
- Keep OAuth tokens, API keys, bot tokens, channel IDs, and account IDs in connector settings or workflow props, not in reusable public template text.
- Test with the visual editor or `POST /v1/actions/{type}/test` before routing production traffic.

## Related Templates

| Template | Description | Tags |
| --- | --- | --- |
| [Payments: Approve email invoices in Slack, pay in USDC](https://b3os.org/templates/invoice-email-slack-approval-usdc-payment) | Monitors your Gmail for invoices that accept crypto. When one arrives, the workflow parses th... | payment, onchain-ops, developer |

## FAQ

**How can I automate my crypto-related emails with B3OS?**

You can use B3OS to monitor your Gmail inbox for specific keywords, such as 'transaction confirmed' or 'governance proposal,' and trigger automated workflows instantly when those emails arrive.
  **Can I trigger workflows based on specific sender addresses?**

Yes, by using the 'Gmail: New Email Matching Search' trigger, you can set filters to only initiate workflows when emails are received from specific exchange addresses, wallet providers, or DAO members.
  **Is my Gmail data secure when using B3OS integrations?**

Security is our priority. B3OS uses industry-standard OAuth protocols to ensure that your Gmail access is restricted only to the necessary data required to execute your defined automation workflows.
  **What is the difference between the two Gmail triggers?**

The 'New Email Received' trigger fires for every incoming message, while 'New Email Matching Search' allows you to use advanced Gmail search queries to filter for specific criteria before starting a workflow.
  **Can I use Gmail automation for real-time on-chain monitoring?**

While Gmail is an off-chain tool, it serves as an excellent bridge. If you receive email alerts from blockchain explorers or node providers, B3OS can turn those alerts into actionable on-chain or off-chain automation tasks.