Documentation Index
Fetch the complete documentation index at: https://docs.weav.com/llms.txt
Use this file to discover all available pages before exploring further.
Overview
A Google Group is a shared address (likesupport@yourcompany.com) that delivers email to several people at once. It’s not a normal mailbox — it’s more like a list. That makes connecting it to Weav slightly different from connecting a regular email address.
You have two ways to connect a Google Group to Weav. Both work; one needs Google Workspace admin access, and one only needs Group owner access.
| Method | Who can do it | When to use it |
|---|---|---|
| Default Routing (recommended) | Google Workspace admin | You want the cleanest setup. Works for any group, with no changes to the group itself. |
| Add Weav as a Group member | Group owner | You don’t have admin access to Google Workspace, or you want the group to keep working normally for your team too. |
This guide covers the inbound side — receiving customer emails sent to your group. To send replies from your group address (e.g.
support@yourcompany.com), you’ll also need to set up your domain — see Add DNS records at your domain provider.Before you begin
Make sure you have:- A Google Group already set up (e.g.
support@yourcompany.com) - Either Google Workspace admin access (for Method 1), or access to manage your Group as an owner (for Method 2)
- Access to Settings → Inbox Settings in Weav
workspace@weav-mail.com (This is only an example, use the workspace email given to you in Weav). You’ll see it in Weav after you add your group address.
Step 1: Add your group address in Weav
Do this in Weav first — it gives you the Weav inbox address you’ll need on the Google side.- In Weav, go to Settings → Email
- Click Add Email Address
- Enter your Group’s email address (e.g.
support@yourcompany.com) - Choose:
- Inbound if you only want to receive emails into Weav
- Both if you also want to send replies from this address
- Click Save
- Find your new address in the list and click Verify in the Incoming column. Weav will show you an internal address that looks like
workspace@weav-mail.com— copy this address, you’ll paste it into Google in the next step.
Step 2: Send group emails to Weav (pick one method)
Method 1: Default Routing (recommended, requires Google Workspace admin)
This is the cleanest setup. You’ll add a routing rule in the Google Workspace Admin Console that automatically sends emails for your group address to Weav. The group itself doesn’t change — your team can still receive group mail normally.In Google Workspace
- Sign in to the Google Workspace Admin Console at admin.google.com with an admin account.
- Go to Apps → Google Workspace → Gmail.
- Scroll to Default routing and click Configure.
- Set up the rule:
- In Envelope recipient, choose Single recipient and enter your group address (e.g.
support@yourcompany.com). - In the action section, check Also deliver to and enter the Weav inbox address you copied in Step 1 (e.g.
workspace@weav-mail.com). - Under Options, select Perform this action on non-recognized and recognized addresses.
- In Envelope recipient, choose Single recipient and enter your group address (e.g.
- Click Save at the bottom of the rule.
We use Also deliver to, not Change envelope recipient. This way, your group keeps receiving messages as it does today — Weav just gets a copy.
In Weav
- Return to Settings → Inbox Settings.
- Click Test Forwarding (or the Verify button) for your group address.
- Weav sends a test email from
Weav <hello@weav.com>. As soon as that test email reaches Weav through your routing rule, the address is automatically marked verified.
Method 2: Add Weav as a Group member (no admin access needed)
Use this method if you’re a Group owner but not a Workspace admin. You’ll add your Weav inbox address as an external member of the Group, so Google delivers a copy of every group email to Weav.In Google Groups
- Go to Google Groups at groups.google.com and open your group (e.g.
support@yourcompany.com). - In the left menu, click Members.
- Click Add members.
- In Group members, paste your Weav inbox address (the
workspace@weav-mail.comaddress you copied in Step 1). - Set Subscription to Each email (so every message is delivered, not digested).
- Click Add members.
Check your group settings (still in Google)
A few group settings can quietly block emails from reaching Weav. Confirm these:- In your Group, go to Group settings → Posting policies:
- Who can post: set to Anyone on the web (or at minimum, allow posts from outside your organization). If only members can post, customer emails will be rejected.
- Message moderation: set to No moderation. If messages are held for moderation, the verification email will sit in a queue and the test will fail.
- In Group settings → Email options:
- Make sure Subject prefix is empty (or be aware Weav will see it on every subject line).
In Weav
- Return to Settings → Inbox Settings.
- Click Test Forwarding (or the Verify button) for your group address.
- Weav sends a test email from
Weav <hello@weav.com>to your group. If your group settings are correct, the test will be delivered to Weav and the address will be marked verified within a couple of minutes.
Step 3: Send outgoing emails from your group address
If you also want to send replies fromsupport@yourcompany.com (instead of from the default workspace@weav-mail.com), you’ll need to authenticate your domain.
Follow Add DNS records at your domain provider to add the DKIM and Return-Path records Weav shows you. Once your domain is verified, replies from Weav will go out as your group address.
You don’t need to do this just to receive group emails. It’s only required if you want outbound messages from Weav to appear as coming from your group address.
Common issues and fixes
The verification test never succeeds
The test email is sent fromWeav <hello@weav.com> and has to reach Weav within 5 minutes. Most failures fall into one of these buckets:
- Method 1 (Default Routing): The rule may still be propagating. Wait a few minutes and try again.
- Method 2 (External member): Your group is holding the test message for moderation. Approve the moderated message, or set Message moderation to No moderation and rerun the test.
- Either method: Your group rejects external senders. Allow posts from outside your organization, or whitelist
hello@weav.com.
Customer emails come into Weav, but the customer is wrong (it shows as your group address)
This happens when Google Groups rewrites the sender to be the group address. To fix it:- In your Google Group, go to Group settings → Posting policies.
- Look for any setting like Post replies to → the group or Set sender as group. Change it so replies and posts go to the original author, not to the group.
- If you can’t change this, switch to Method 1 (Default Routing) — Default Routing preserves the original sender automatically.
Customer emails are being marked as spam in Weav
Forwarding through a group can break SPF, which raises the spam score on relayed messages. Fix this by adding the customer’s domain (or a partner domain) to your Trusted Senders list:- In Weav, go to Settings → Email → Preferences.
- Find Trusted Domains and add the domain (e.g.
customerdomain.com). - Emails from that domain will skip spam filtering.
Replies from my team aren’t threading correctly
Make sure your Google Group isn’t configured to rewrite the Message-ID header. The default Google Group settings preserve it. If you’ve enabled conversation history rewriting or moderation that modifies headers, switch to Method 1 (Default Routing) instead.My team still wants to see group emails in Gmail
Both methods support this:- Method 1 (Default Routing) uses Also deliver to, so your team keeps receiving group mail in Gmail and Weav gets a copy.
- Method 2 (External member) keeps the group itself working — you’ve just added Weav as an additional member.
Status reference
| Status | Meaning | What to do |
|---|---|---|
| Verified | Your group is connected and forwarding to Weav | No action needed |
| Pending | Waiting for the verification test to arrive at Weav | Wait a few minutes, then click Test Forwarding |
| Not tested | You haven’t run the forwarding test yet | Click Test Forwarding |
| Failed | The test didn’t reach Weav within 5 minutes | Check group settings (above), then retry |

