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

# Push to Gmail

> Set every person's Gmail signature across your Google Workspace domain, and keep it in sync when their details or the design change.

With push to Gmail, nobody has to copy and paste. Swashmo sets each person's Gmail signature for
your whole Google Workspace domain, and sets it again whenever their details, their design, the
brand kit or a campaign banner change.

> [!NOTE]
>
> Push to Gmail is on the Team plan. During early access we set it up with you:
> [tell us what you need](https://swashmo.com/pricing/#contact). The Google access below also
> powers the [Google Workspace import](https://docs.swashmo.com/admins/add-people.md#from-google-workspace), which is on the
> Free plan.

## Before you start

* You need to be an **owner or admin** in Swashmo.
* In Google Workspace you need a **super administrator**, who can grant domain-wide delegation
  in the Google Admin console.

## Grant access in Google Admin

Swashmo acts through its own Google service account, which your Google admin authorises for your
domain. **Settings → Gmail** in Swashmo shows its **Client ID** and the **Scopes** to paste, each
with a copy button.

**1. Open API controls**

Open the Google Admin console → **Security → Access and data control → API controls**.

**2. Add Swashmo**

Click **Manage domain-wide delegation**, then **Add new**.

**3. Paste the client ID and scopes**

Paste the client ID and the scopes from **Settings → Gmail**, then click **Authorize**. The
scopes are:

```text theme={null}
https://www.googleapis.com/auth/gmail.settings.basic
https://www.googleapis.com/auth/admin.directory.user.readonly
```

**4. Turn on pushing in Swashmo**

Back in **Settings → Gmail**, enter your **Google Workspace domain** (for example
`example.com`) and an **Admin email**: a Google Workspace admin the service account acts as,
to read the directory. Switch on **Push signatures** and click **Save**.

## What gets pushed

* Each person's **primary** signature is set on their primary Gmail address. Their other
  signatures stay in Swashmo to copy by hand; see
  [Several signatures per person](https://docs.swashmo.com/signatures/several-signatures.md).
* Swashmo pushes after every change to a person, a design, the brand kit or a campaign banner, and
  again every night. People whose signature hasn't changed are skipped.
* **Sync now** in **Settings → Gmail** pushes straight away. The panel shows the last sync and how
  many signatures were pushed or failed; **People** shows **Pushed** or **Push failed** for each
  person.

## What Swashmo can and can't do

With these scopes Swashmo can change Gmail **signature settings** and read your **user
directory**. It never reads, stores or sends email, and never writes to your directory.

## Stop pushing

Switch off **Push signatures** in **Settings → Gmail** and save: from then on nothing is changed
in Gmail, and signatures already set stay as they are. To remove Swashmo's access completely,
delete its client ID under **Manage domain-wide delegation** in the Google Admin console; Swashmo
stops acting for your domain at once.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.