Gmail connection guide
Last updated: June 13, 2026
TenthAvenue's Inbox connects to your own Gmail mailbox, so the conversations you have with your contacts show up on their records, and the email you write in TenthAvenue goes out from your own address. Each teammate connects only their own mailbox. This guide explains what the connection reads, how to add it, who sees what, and how to remove it and delete your data. It also covers syncing your Google Contacts.
What we access and why
Connecting asks Google for these permissions and no others:
openid: identifies which Google account you connected.userinfo.email: reads that account’s email address, so we know which mailbox is yours.gmail.modify: reads your messages so they sync to TenthAvenue, and acts on them only when you ask: sending the email you write in TenthAvenue from your own address, replying and forwarding, moving to Trash, archiving, applying labels, marking read or unread, and saving drafts. It cannot delete anything permanently.
For each synced message we keep the sender, recipients, subject, a short preview, its labels and whether it is read. We keep the body only when someone on the message is already a contact in your workspace; any other body is read from Gmail when you open the message and is not stored. Attachments stay in Gmail; we keep only each attachment's name, size and type, and read a file from Gmail only when you open it or forward it, never storing it. Everything is in our database in the United States, encrypted in transit and at rest, and the keys to your mailbox are encrypted again before we store them.
Connecting Gmail
- Sign in to TenthAvenue and open Settings → Integrations.
- Click Connect Gmail. TenthAvenue first shows what it reads, why, and who sees it, and asks how much history to bring in: the last 12 months (recommended) or everything. Choose, then click Continue to Google.
- Choose your Google account. Google lists each permission with a box beside it: leave every box ticked, then click Continue.
- You come back to Integrations, where your mailbox shows as Connected. Under What to sync, keep Everything or choose the labels to sync.
Gmail is being opened workspace by workspace. If you do not see Connect Gmail, it is not on for your workspace yet: email support@tenthavenue.io.
What syncs
- New mail arrives within a few minutes. Your history (the last 12 months, or everything) comes in behind it, newest first, up to 300 messages every couple of minutes; the Inbox shows how far it has got. A large mailbox can take a day or more.
- Every label is synced except Drafts, Spam and Trash, unless you choose them under What to sync.
- Your Inbox follows Gmail: a message you delete or move to Trash in Gmail leaves it, and archiving and read or unread show there too; a message you move back comes back. Entries already on a contact's timeline stay.
- If the sync ever loses its place in your Gmail (after a long pause, say), it checks your whole history again: what it missed comes in, and what you deleted meanwhile leaves.
- A message is matched to a contact by any of the contact's email addresses, for everyone on it (the sender, To and Cc), except your teammates. It is also placed with a company when that company's domain matches, never for free email providers like Gmail or Outlook, or your own domain.
Writing email in TenthAvenue
- Every email button in TenthAvenue (on a contact, a company, a deal, a booking, a meeting recap) opens the same composer. It sends from your connected mailbox, so the email lands in your Sent folder and replies thread normally. With no mailbox connected, the composer offers Connect and nothing else.
- You can send from your Gmail address or any send-as address you have set up in Gmail. We read your send-as addresses and their signatures from Gmail. Of those settings we keep only the addresses, and we read the signatures again each time you write. A signature you include becomes part of that email, so it is kept wherever the email's words are: with a scheduled email until it goes out, with a batch email until you disconnect, in the synced copy of the sent email when someone on it is a contact, and on the timeline when it falls within the first 2,000 characters kept there.
- Your signature: add a TenthAvenue signature in Settings → Integrations, under your mailbox. It replaces your Gmail signature in TenthAvenue, and it is the one Outlook email uses. Untick Include signature to leave it off one email.
- Attach files from your device: they are sent with the email and never stored by us.
- Insert a template from the composer's toolbar: your own, or one your workspace shares. Merge fields such as
{{first_name}}fill in for the person you write to, and any the composer cannot fill are named before you send. Keep your templates in Settings → Templates. - Draft with Sam writes the message, or rewrites what you wrote, from a line you type. It reads the email you are answering and the contact's record, including your recent emails with them and a teammate's only as far as that teammate shares them (never a private thread). The draft lands in the composer for you to edit; nothing is sent until you press Send. It uses your workspace's TAC.
- Pick Send later in the menu beside Send to choose when the email goes out. It waits in TenthAvenue (what you wrote, with the signature you included, but without files, which are never stored) and is sent from your mailbox at that time the same way Send would send it, then we delete our copy. Change it, send it now or cancel it from Inbox → Scheduled. One that could not be sent stays there with the reason until you send it, change it or cancel it. Disconnecting your mailbox cancels what is waiting, and we tell you.
- After you click Send you have a few seconds to undo. The email is then added to the timeline of the contacts on its To and Cc lines (never Bcc) and of their company, with its subject and the first 2,000 characters of what you wrote.
Batch email
Send one email to up to 50 people at a time from your own mailbox, each their own.
- In Contacts (or Deals, for each deal's main contact), select up to 50 people and choose Email from my mailbox. More than 50 at once belongs in Megaphone, which sends from your workspace's own sending domain.
- Write it once. Merge fields such as
{{first_name}},{{last_name}},{{full_name}}and{{company}}fill in for each person, and Preview each email steps through them one by one. - Before it goes out you see who is left out and why: unsubscribed or opted out, an email that bounced before, no email address, one that is not valid, or someone already in the batch.
- Each person gets their own email from your address, never a shared To, Cc or Bcc, a few seconds apart. It lands in your Sent folder and on that contact's timeline like any email you send.
- TenthAvenue sends at most 300 emails in any 24 hours from a personal Gmail address and 1,000 from a Google Workspace one, counting every email it sent from your mailbox. The composer shows what is left today and refuses a batch larger than that.
- An unsubscribe line is on by default: your company's postal address (set it in Settings, Organization) and each person's own unsubscribe link, plus the headers that give mail programs an unsubscribe button. Whoever unsubscribes is left out of every later batch and campaign. You can turn the line off for one batch; that is recorded with it.
- If Gmail asks us to slow down, reaches its daily limit, or stops accepting our access, the batch pauses and says why; Resume sends the rest from where it stopped, or Cancel stops it.
- The batch's report (from the toast when it starts, your notifications, or Inbox → Batch emails) shows who it was sent to, who replied, whose address bounced, and anything that failed. A reply in the conversation marks the person replied and tells you; a delivery failure notice marks the address bounced and keeps it out of future email.
- We keep each batch (what you wrote, with the signature you included, who it went to with the details filled in for each person, and what happened to each email) for its report, which only you can open, until you disconnect your mailbox.
Answering and tidying your Inbox
Everything here happens only when you ask for it, on your own mail.
- Reply, Reply all and Forward on a message in your Inbox open the same composer, filled in: Reply all leaves you and your send-as addresses out, the subject gets "Re:" or "Fwd:", and the original is quoted below what you write (open it to read it, or leave it out). The answer stays in the same Gmail conversation and lands in your Sent folder.
- A forward carries the original's attachments: each is read from Gmail when the email sends and never stored by us, and you can leave any of them out.
- Trash (with Undo), Archive, Move to Inbox and Mark read or unread change the message in Gmail right away, for one message or for several you select. Opening an unread message marks it read, as Gmail does. On a keyboard: r replies, a replies to all, f forwards, e archives and # moves to Trash.
- To open an attachment, click it: TenthAvenue reads it from Gmail at that moment and hands it to you as a download. It is never stored.
- Remove from TenthAvenue takes a message out of TenthAvenue only: its copy here and the timeline entries your mailbox added for it are deleted, and Gmail keeps it untouched. We keep only its Gmail message id, so the sync never brings it back; disconnecting deletes that too.
Who sees what
- Your Inbox in TenthAvenue is yours alone: teammates cannot open it.
- When a message is with someone who is, or later becomes, a contact in your workspace, it is added to that contact's activity timeline and Email tab, and to their company's. What your teammates see of it is your choice, in Settings → Integrations under your mailbox: Private (no entry teammates can see; the email still counts toward the last activity date of the contact, their company and the deal, the contact's engagement temperature and a Relay handoff's first touch, and an investor stage it moves is still logged), Date and people (when you emailed and with whom, never the subject or the words), Subject and preview (the default, and how TenthAvenue has always worked), or Full (teammates can also open the whole email from the contact's or company's Email tab; when we do not already keep its text, we fetch it from Google with your access for that one view and do not store it; its files open only for you). You always see all of your own.
- Your workspace's owners and admins can set the default for everyone who has not chosen, at most Subject and preview (only you can let teammates open your whole emails), and a limit nobody can go above. Lowering the limit, or your own choice, takes the subject and preview off your earlier timeline entries too.
- Make any thread private from the contact's Email tab: teammates then see no entry for it, whatever your choice, though its email still counts in the same places as Private email (the last activity dates, the engagement temperature, a Relay handoff's first touch and a logged stage move). A filter on how many emails a contact has counts a teammate's email only as far as that teammate shares it: never email they keep private, and never a private thread.
- List people or whole domains never to sync (a lawyer, a doctor, your family's domain). Mail with anyone on the list is never copied into TenthAvenue or logged, and adding someone removes what was already synced with them, timeline entries included.
- Link to deal on one of your emails puts its whole conversation on a deal: every email of it in your mailbox, those already synced and those still to come, shows on the deal's timeline and Email tab, with the same choice of what teammates see (a private conversation stays yours alone). Unlink takes them off again; emails you sent from the deal itself stay on it.
- People you email, at the top of your Inbox, lists the people you email often who are not contacts yet, built only from your own mailbox and shown only to you. Dismiss hides someone for good. Add as contact adds them (with their company from their email address, if you keep that on), and the email your workspace's connected mailboxes already synced with them goes on their timeline, each as far as its owner shares it.
- Automations: when a contact replies in your mailbox to email from your workspace (an email you sent, or one your workspace sent), the reply can start and steer your workspace's automations that begin with Contact replies (email). Its subject (only “Email” if you share Date and people), the sender's address and when it arrived only decide whether an automation runs and appear in notices to your workspace's own team in the app; a phone notification shows only “A contact replied by email”. They are held in your workspace's automation queue only until the automation has run (through any wait step it has), and are never saved into a contact, deal, task or note, sent to a webhook, put in a text message or given to an AI step; the body is never used. Email you keep Private, a private thread, forwards, out-of-office answers and bounces never start one.
- Meeting prep briefs and suggested next steps send the subject and preview of those emails (on a contact, company or deal) to our AI provider, only to write that result: a brief on a Meridian booking (which the booking's teammates can read) uses only email whose owner shares at least its subject with teammates (never a private thread); a brief on a meeting from your own calendar is yours alone, so it uses all of your own email with the contacts on it and a teammate's only as far as that teammate shares it (never their private threads or Private email); and a suggestion uses only email the person asking for it can see. Draft with Sam also sends the email you are answering, read from your own mailbox, only to write your draft. Your email is never used to train AI, never used for advertising, and never sold.
- After a meeting, Save to Gmail drafts on its recap saves the follow-up email into your Gmail Drafts, only when you click it; it sends nothing, and you edit and send it from Gmail. Reply in your thread opens it in the composer as a reply to your latest email with them, so it stays in that conversation.
- People at TenthAvenue do not read your email unless you ask us to about a specific message, or security or the law requires it. Even when our support team signs in to help your workspace, your email stays closed to them: they cannot open your Inbox or send from it, and they see no email subjects, previews or prep briefs.
Troubleshooting
- "One of the permissions was left unticked." TenthAvenue cannot sync without all of them, and nothing was kept. Click Connect Gmail again and leave every box ticked.
- "That mailbox is already connected." A mailbox can be connected in one place at a time. Disconnect it in the other workspace (or ask the teammate who connected it), then connect it here.
- "Last sync error" on Integrations. Your connection may have expired or been removed at Google. Disconnect, then connect again.
- Still stuck? Email support@tenthavenue.io with your workspace name.
Disconnecting and deleting your data
- In TenthAvenue: open Settings → Integrations and click Disconnect. We ask Google to withdraw our access, then delete every synced copy of your mail and the stored keys. If a Google Contacts sync uses the same Google account, our access stays until no sync uses it (Google withdraws a whole connection at once).
- At Google: visit myaccount.google.com/permissions, open the TenthAvenue entry whose access includes Gmail, and remove its access. TenthAvenue can be listed more than once there if you also sign in with Google or connected Google Calendar; each entry says what it can reach, so choose the one that lists Gmail. Then click Disconnect in TenthAvenue too, so the copies we hold are deleted.
- Being removed from a workspace, or deleting your TenthAvenue account (see Delete your account), does the same for your mailbox.
- Timeline entries already added (a subject and a short preview on a contact, or only the date and people if that is what you share) belong to your workspace's records and stay with them, still under your choice of who sees them.
- To ask us to delete those entries, or anything else we hold about you, email support@tenthavenue.io.
Google Contacts
You can also keep your own Google Contacts and your TenthAvenue contacts in step. It is a separate step from Gmail, on the same Google connection, and each teammate syncs only their own Google account.
openid: to identify the Google account you connectuserinfo.email: to know which Google account it iscontacts: to read your Google Contacts, and to create the contacts you own in TenthAvenue inside a TenthAvenue label and keep only those up to date (never to delete one)contacts.other.readonly: to read the Other contacts Gmail saved for you, only if you choose to bring them in
- Open Settings → Integrations and click Sync Google Contacts. TenthAvenue first shows what it reads, what it writes and who sees it. Tick the box if you also want the people Gmail saved for you automatically ("Other contacts"), then click Continue to Google.
- Choose your Google account and leave every box ticked. Google says the permission can delete contacts; TenthAvenue never does.
- The first import runs within a few minutes, and a large address book finishes over a few passes. Sync now runs a pass right away.
- Each contact's name, email addresses, phone numbers, company, job title and address come in. Someone already in your workspace is matched by email (or by phone number when the name matches too), and only their empty details are filled in; anyone else becomes a new contact you own, which your teammates can see like any other contact.
- Nothing in your workspace is ever removed or emptied: email addresses and phone numbers are only added. On contacts you own, a detail you change in Google replaces the one here (when both sides changed it, the newer change wins); a teammate's contact only gets its empty details filled in.
- TenthAvenue creates each contact you own here that your Google Contacts lacks in a TenthAvenue label there, never with your notes, and keeps only those up to date: it changes just the details you changed in TenthAvenue and keeps every other detail, label and type you add in Google. Contacts you already had in Google are only read. Your workspace's owners and admins can turn this off; contacts still come in from Google then.
- Each contact TenthAvenue creates is marked with its workspace, so the same Google account connected in two workspaces never brings one workspace's contacts into the other.
- Nothing is ever deleted. Deleting a contact in Google or in TenthAvenue only stops syncing it, and the sync never brings it back.
- Receipts and no-reply senders among your Other contacts are left out.
Stopping: click Stop syncing on the Google Contacts card. The stored keys and links are deleted, and the contacts already added stay in your workspace. We ask Google to withdraw our access unless a Gmail connection or another Contacts sync uses the same Google account (Google withdraws a whole connection at once); our access then goes when the last of them stops, or remove it yourself at myaccount.google.com/permissions. Being removed from a workspace, or deleting your account, stops your syncs the same way.
Support and policies
Questions: support@tenthavenue.io. How we handle data is in our Privacy Policy, including the Google API Services User Data Policy commitments (Limited Use), and our Terms of Service.
