---
title: Gmail Integration
description: "[**Mria CRM: Gmail Connector**](https://marketplace.atlassian.com/apps/2844663404/mria-crm-gmail-connector) is a separate Atlassian Forge app that works exclusively as a satellite of **Mria CRM**. It has its own billing on the Atlassian Marketplace, but its only purpose is to bring Gmail email sync into Mria…"
url: "https://mriacrm.com/docs/gmail-integration/"
updated: "2026-11-18"
category: Email Integrations
---

# Gmail Integration

[**Mria CRM: Gmail Connector**](https://marketplace.atlassian.com/apps/2844663404/mria-crm-gmail-connector) is a separate Atlassian Forge app that works exclusively as a satellite of **Mria CRM**. It has its own billing on the Atlassian Marketplace, but its only purpose is to bring Gmail email sync into Mria CRM — every sent and received email is automatically linked to matching Contacts, Leads and Deals.

The connector uses Google OAuth and is **CASA-certified**, so it is approved by Google for accessing Gmail data on your behalf. Sync runs **every 5 minutes** in both directions — incoming and outgoing emails are pulled into Mria CRM, and emails sent from Mria CRM are delivered through Gmail.

This page covers two parts:

## Part 1. Setting up Mria Gmail Connector

Mria Gmail Connector is installed and managed separately from Mria CRM, but it must be linked to a Mria CRM site to work. Once linked, any user can connect their personal Gmail account and choose how their emails are shared.

[![Gmail Integration: Part 1. Setting up Mria Gmail Connector](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-01.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-01.png)

### 1.1 Opening the App

After installation, open **Mria Gmail Connector** from the Atlassian app switcher. The app has its own navigation:

- **Accounts** — connect Mria CRM and manage Gmail accounts.
- **Settings** — global settings (admin only).
- **Documentation** and **Help** — external links.

When you open the app for the first time, the **Accounts** page shows an empty state with the message *"Mria CRM is not connected"*. The **Add Gmail Account** button is disabled until Mria CRM is connected.

[![Gmail Integration: Opening the App](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-02.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-02.png)

### 1.2 Enabling App REST APIs (Admin Only)

Before any user can connect Mria CRM to the Mria Gmail Connector, an Atlassian site admin must enable REST API access for the Mria CRM app. The connector uses these APIs to read and write CRM records during sync — without them, the OAuth consent in 1.3 succeeds but no emails will sync.

To enable:

1. Go to **Atlassian Administration** → select your site.
2. Open **Site settings** → **Connected apps**.
3. Select **Mria CRM** from the list.
4. Scroll to the **App REST APIs** section and click **Enable app REST APIs**.

Once enabled, the section shows an **ENABLED** badge and displays the **Base URL** for the app. You (or any user) can now proceed to 1.3 *Connecting to Mria CRM*.

[![Gmail Integration: Enabling App REST APIs (Admin Only)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-03.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-03.png)

Only verified Atlassian accounts in your organization can create integrations against these APIs. If the **Enable app REST APIs** button isn't visible, confirm you have site admin permissions for the Atlassian organization.

### 1.3 Connecting to Mria CRM

Once App REST APIs are enabled (see 1.2), link Mria Gmail Connector to your Mria CRM site:

1. On the **Accounts** page, click **Connect Mria CRM**.
2. You will be redirected to the Atlassian OAuth consent screen for **Mria CRM OAuth**.
3. In the **Use app on** dropdown, choose the Atlassian site where Mria CRM is installed (e.g. `mriacorp-test.atlassian.net`).
4. Review the requested permissions:
   - **In Jira** — *View*: Forge app, jira-user, jira-work
   - **In Mria** — *Access*: Read profile, Email Integration
5. Click **Accept**.

Once consent is granted, you are returned to the Accounts page and the banner switches to *"Connected to Mria CRM"*. The **Add Gmail Account** button is now active.

[![Gmail Integration: Connecting to Mria CRM](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-04.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-04.png)

[![Gmail Integration: Connecting to Mria CRM](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-05.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-05.png)

📌 You can later click **Disconnect Mria CRM** to break the link. Disconnecting stops all email sync until Mria CRM is reconnected.

### 1.4 Adding a Gmail Account

Once Mria CRM is connected, each user can add their own Gmail account:

1. On the **Accounts** page, click **+ Add Gmail Account** in the top-right corner of the **Gmail Accounts** section.

[![Gmail Integration: Adding a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-06.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-06.png)

1. A confirmation dialog appears: *"Opening external page on accounts.google.com"*. Click **Continue**.

[![Gmail Integration: Adding a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-07.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-07.png)

1. On the Google **Sign in with Google** screen, choose the Gmail account you want to connect, or click **Use another account**.

[![Gmail Integration: Adding a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-08.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-08.png)

1. If you have signed in before, Google shows a *"You're signing in"* screen — click **Continue**.

[![Gmail Integration: Adding a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-09.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-09.png)

1. Approve the requested Gmail scopes.

[![Gmail Integration: Adding a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-10.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-10.png)

After authorization, you are redirected back to Mria Gmail Connector and the new Gmail account appears in the **Gmail Accounts** table.

📌 Each user can connect more than one Gmail account (for example, a corporate and a personal mailbox). All emails from connected accounts are then routed into Mria CRM.

### 1.5 Managing Connected Accounts

The **Gmail Accounts** table shows every Gmail account connected to this Mria CRM site. For each account you can see:

- **Name** and avatar of the Gmail user
- **Email** address
- **Status** — *Active* (sync is running) or *Inactive* (sync is paused)
- **Visibility** — *Private*, *Public*, or *Shared*
- **Last Synced At** — timestamp of the most recent sync
- **Owner** — the Mria CRM user who connected this account
- **Actions** — *Edit* and the `...` menu (Disconnect)

You can only **Edit** or **Disconnect** Gmail accounts that you own. Other users' accounts are visible but read-only.

### 1.6 Gmail Connection Settings

Click **Edit** next to your Gmail account to open the **Gmail Connection Settings** dialog. It controls how the account syncs and who can see the synced emails.

[![Gmail Integration: Gmail Connection Settings](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-11.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-11.png)

#### Status

Controls whether Gmail syncing with Mria CRM is active.

- **Active** — incoming and outgoing emails are synced to Mria CRM.
- **Inactive** — email syncing is paused. Already synced emails remain visible in Mria CRM.

[![Gmail Integration: Status](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-12.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-12.png)

#### Visibility

Controls who in Mria CRM can see the emails synced from this Gmail account.

| Visibility | Who can see synced emails |
| --- | --- |
| **Private** | Only you (the Gmail account owner). |
| **Public** | All users in your Mria CRM site. |
| **Shared** | Only specific Mria CRM users you select. |

##### Public visibility

Switching to **Public** opens a confirmation dialog warning that anyone in Mria CRM will be able to view your synced email conversations wherever they appear in the CRM, including potentially sensitive content (customer details, internal discussions, attachments, personal information).

You must click **Make Public** to confirm.

[![Gmail Integration: Public visibility](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-13.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-13.png)

##### Shared visibility

Switching to **Shared** reveals a **Shared Users** picker where you select specific Mria CRM users.

When you save changes that share emails with new users, a confirmation dialog appears reminding you that shared emails linked to CRM records may become accessible anywhere those users have record access.

You must click **Share Emails** to confirm.

[![Gmail Integration: Shared visibility](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-14.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-14.png)

#### Restrictions

Controls **which incoming emails** are synced to Mria CRM. Restrictions affect future emails only — already synced messages are not removed.

| Restriction | Behavior |
| --- | --- |
| **No restrictions** | All incoming emails are synced. |
| **Excluded email addresses** | Skip emails from addresses you list. |
| **Allowed email addresses** | Sync only emails from addresses you list. |

[![Gmail Integration: Restrictions](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-15.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-15.png)

📌 Click **Save** to apply changes. **Cancel** discards them.

### 1.7 Disconnecting a Gmail Account

To disconnect a Gmail account you own, open the `...` menu next to it and select **Disconnect**.

[![Gmail Integration: Disconnecting a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-16.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-16.png)

A confirmation dialog appears explaining what will happen:

- The Gmail account is unlinked from Mria Gmail Connector.
- All emails associated with this account are removed from the connector.
- By default, **emails are NOT deleted** from the connected Atlassian app (Mria CRM) — they stay attached to their CRM records.

If your Mria CRM admin has enabled the corresponding global setting (see 1.8 Global Settings), an additional option to also delete synced emails from Mria CRM may appear.

Click **Disconnect** to confirm.

[![Gmail Integration: Disconnecting a Gmail Account](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-17.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-17.png)

### 1.8 Global Settings (Admin Only)

The **Settings** tab contains site-wide options that only Atlassian admins can change.

**General → Global Settings**:

- **Enable option to delete synced emails when disconnecting a Gmail account** — when enabled, users will see an additional checkbox in the Disconnect Account dialog allowing them to also remove synced emails from Mria CRM. By default this option is off, so disconnecting is non-destructive for CRM data.

Non-admin users see the Settings page in read-only mode (the **ADMIN ONLY** badge indicates restricted access).

[![Gmail Integration: Global Settings (Admin Only)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-18.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-18.png)

#### Syncing emails — importing earlier mail

By default a connector only syncs mail that arrives **after** a mailbox is connected, so conversations that predate the connection never reach Mria CRM. **Sync emails from** fills that gap: set a date and the connector imports the history from that point forward.

- Emails **received or sent on or after** the date are imported. The date is read in **UTC**.
- The setting is **site-wide** — it applies to **every connected mailbox**, not just your own.
- You can go back **one year at most**.
- The further back you go, the longer the **first sync** takes. After that, normal five-minute syncing continues as usual.
- Clearing the date **stops further import**. Emails that were already imported stay in Mria CRM — clearing the field is not an undo.

[![Gmail Integration: Syncing emails  importing earlier mail](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-19.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-19.png)

This is an admin-only, site-wide setting, and it pulls real mail into a CRM that other people can read. Before setting a date, check the **Visibility** and **Restrictions** on each connected mailbox (see 1.6) — a mailbox set to **Public** will expose its imported history to the whole workspace.

## Part 2. Using Gmail Integration in Mria CRM

Once at least one Gmail account is connected and active, Gmail Integration becomes available inside **Mria CRM** on Contact, Lead, and Deal records.

**Before any Gmail account is connected:** opening the **Emails** tab on a Contact or Lead shows a connector banner with quick links to **Mria Gmail Connector** — one to open the connector app directly, and one to the setup guide. Once an active Gmail account is in place, the banner is replaced by the email composer described below.

### 2.1 Sending Emails from a Record

You can compose and send emails directly from a CRM record:

1. Open a **Contact**, **Lead**, or **Deal**.
2. Switch to the **Emails** tab in the main panel.
3. Choose the sending Gmail account in the **From** dropdown — the list shows every active Gmail account you can send from (your own accounts plus any account shared with you with send rights)
4. Check the **To** field. It is **pre-filled automatically** from the record you're on — the Contact's email address, the Contact linked to a Lead, or every Contact linked to a Deal. You can remove a recipient with the × on its chip, or add another address if needed.
5. Optionally, add one or more CC recipients to copy others on the email — useful when looping in colleagues or external stakeholders. Each CC address is added as a chip; click the × to remove one..
6. Fill in the **Subject** and the email body — or insert a saved **Template** (see below). The editor supports basic formatting (bold, italic, underline, strikethrough, headings, alignment, bulleted and numbered lists) and **inline images**.
7. Click **Send**.

The email is delivered through Gmail and appears in the record's **Emails** list.

[![Gmail Integration: Sending Emails from a Record](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-20.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-20.png)

📌 The recipient is taken from the record (the Contact's email, or the Contact linked to the Lead / Deal). Emails sent this way are automatically linked to that record.

#### Using an email template

The **Template** button sits to the right of the **Subject** field. It opens a picker with your own templates and everything shared publicly in the workspace, plus a **preview filled in for the record you're on** — merge fields like `{{contact.name}}` already resolved, so you see the real email before inserting it.

**Insert template** fills in the subject and body, which you can then edit before sending. If you've just written something worth keeping, **+ Save as template** in the composer footer turns the current draft into a reusable template.

See [Email Templates](/docs/email-templates/) for creating, sharing, and managing them.

#### Images in emails

The composer supports **images inside the message body**, so signatures, screenshots, product shots, and other inline graphics survive the trip to the recipient instead of being stripped out. Images are also preserved when you **reply to** or **forward** a message.

Images render inline in the **Emails** list too, so a synced message looks in Mria CRM much like it does in the mailbox.

Only image types the connector considers safe are embedded. Anything outside that set is handled as a regular attachment rather than rendered in the body.

#### Attachments

Alongside inline images, the composer can attach files to the message. Click the **paperclip** in the editor toolbar — **Attach files** — and pick one or more files from your computer.

Accepted file types:

```
.pdf  .doc  .docx  .xlsx  .txt  .csv  .png  .jpg  .jpeg  .gif  .json  .zip
```

- Several files can go on one message.
- Attachments travel with the email through the connector, so the recipient gets them as ordinary mail attachments.
- They stay on the synced email in Mria CRM, so the record keeps a copy of what was sent.

[![Gmail Integration: Attachments](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-21.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-21.png)

The **paperclip** sits next to the image button in the toolbar — the image button embeds a picture **inside** the message body, the paperclip sends a file **with** it.

Attaching a file to an email is not the same as the record's **Files** tab. The Files tab stores documents against the Contact, Lead or Deal itself; an attachment belongs to the one email you send it on.

### 2.2 Viewing Synced Emails

Below the composer, the **Emails** section shows the full conversation history for the record. Each email row displays:

- **Direction icon** — incoming or outgoing.
- **Subject** and **status badge** if applicable (e.g. *Pending*).
- **Sender** name and address, with the **to:** recipient on the next line, and **cc:** where present.
- **Date and time**.
- A short **preview** of the message body.

Long threads are paginated.

[![Emails section on a Contact listing synced messages with direction icons, to and cc lines, dates and previews](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-22.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-22.png)

### 2.3 Replying, Forwarding and Unlinking Emails

Each synced email row has its own actions — the **Reply** button and a `…` menu with **Reply all**, **Forward**, **Unlink**, and **Delete**.

[![Gmail Integration: Replying, Forwarding and Unlinking Emails](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-23.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-23.png)

**Reply**, **Reply all** and **Forward** open the composer prefilled from the original message (Reply → the sender; Reply all → the sender and all other recipients; Forward → a new recipient). These actions are available **only to users who are in the email loop** (the sender, a recipient, or someone on CC) — for anyone outside the loop they are blocked.

**Unlink from Contact / Lead / Deal** removes the email from **this record only**. The email stays in Mria CRM and remains visible on every other Contact, Lead, or Deal it is linked to — unlike **Delete** (see 2.5), which removes it from Mria CRM entirely. This is especially useful for Deals: when an email belongs on a Contact but has nothing to do with a particular Deal it was auto-linked to, you can unlink it from the Deal while keeping it on the Contact.

### 2.4 Email Statuses and Sync Behavior

Emails sent from Mria CRM go through a short delivery flow:

- **Pending** — the email has been queued and will be sent on the next sync cycle.
- **Not sent** — the email could not be sent because the Mria Gmail Connector license has expired. It stays queued; see below.
- No badge — the email has been sent and confirmed by Gmail.

[![Gmail Integration: Email Statuses and Sync Behavior](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-24.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-24.png)

**Sync schedule**

Mria Gmail Connector syncs **every 5 minutes** in both directions:

- **Outgoing** — pending emails composed in Mria CRM are picked up and sent through Gmail.
- **Incoming** — new messages in Gmail (matching your Visibility and Restrictions settings) are imported into Mria CRM and linked to the matching Contact or Lead by email address.

If a synced email matches multiple records, it is shown on each of them.

📌 Because sync is interval-based (not real-time), it can take up to 5 minutes for a sent email to appear with no badge, or for a freshly received email to show up in the record.

#### When the Mria Gmail Connector license has expired

Sending from Mria CRM goes through the connector, so it stops when the connector's license lapses. Mria CRM says so on the Emails tab of every record, above the composer:

**Sending is paused — your Mria Gmail Connector license has expired**
New emails will not be delivered until the license is renewed. Emails already in Mria CRM are unaffected.

Administrators get a link to renew the license. Everyone else is asked to contact a site admin.

An email that was already queued shows **Not sent** instead of Pending, with the reason and the date the license expired. Leave it there: once the license is renewed it is sent on the next sync cycle, with no retyping — sending it again by hand would deliver it twice.

Reading is not affected. Emails already synced stay on their records, with their attachments and images.

### 2.5 Deleting a Synced Email

You can remove a synced email from Mria CRM directly from the Emails tab on a Contact, Lead, or Deal.

1. Find the email in the Emails list and open the … menu on that email.
2. Click Delete.
3. In the Delete this email? dialog, review what will happen, then click Delete to confirm — or Cancel to keep the email.

[![Gmail Integration: Deleting a Synced Email](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-25.png)](https://mriacrm.com/wp-content/uploads/2026/11/gmail-integration-25.png)

Deleting removes the email from Mria CRM and cannot be undone:

- The email and any attachments are removed from Mria CRM.
- If the email is linked to more than one record (Contact, Lead, or Deal), it is removed from all of them.
- The original message is not deleted from your mailbox — it stays in the connected email account.

📌 Only an admin or the owner of the connected mailbox can delete a synced email.

✅ Together, **Mria Gmail Connector** and **Mria CRM** keep your Gmail conversations and your CRM records aligned automatically — without leaving Atlassian. For broader CRM functionality, see [Contacts](/docs/contacts/), [Leads](/docs/leads/) and [Deals](/docs/deals/).

 [https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration](https://www.addtoany.com/add_to/facebook?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration)[https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration](https://www.addtoany.com/add_to/x?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration)[https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration](https://www.addtoany.com/add_to/linkedin?linkurl=https%3A%2F%2Fmriacrm.com%2Fdocs%2Fgmail-integration%2F&linkname=Gmail%20Integration)
