Gmail

This is the Gmail app on Apps. A workflow that only drafts replies uses Connect Gmail or Connect your own Gmail. That mailbox is separate, and this app does not take its place.

What it can do

• Read: Get mailbox, List messages, Get message, Get attachment, List threads, Get thread, List labels, List drafts, Get draft and List history.
• Change the mailbox: Change message labels, Move message to trash, Restore message from trash, Change thread labels, Create draft, Update draft, Delete draft, Create label, Watch mailbox and Stop mailbox watch.
• Send outside the company: Send message, Reply to a message and Send draft.

Every call is the signed-in mailbox. One list is one page, not the whole mailbox. Trash can be restored. This app does not delete mail forever. Send draft uses the change permission below, not the send-only permission.

What can start a workflow

• Mailbox history, Message added, Message deleted, Label added and Label removed.
• The notice names the mailbox and a history id. It does not include the mail. List history reads what changed, from the history id saved before.
• Watch mailbox lasts under 7 days. Renew it at least daily. Stop mailbox watch ends it.

How to connect

Open Connections, then Apps. In the Apps heading, search with Search apps to add and choose Add on Gmail.

When the panel offers Who signs in, pick Sign in as the company (one account for every agent) or Each person signs in to their own account when first needed.

Read what it asks for. If it has not said, the panel says You'll see what Gmail asks for on its own sign-in page. Choose Continue to Gmail and finish there. Do not paste a password into Studio. When it works, the row says Connected.

If it says This app can't be connected here yet: it needs a sign-in setup this server doesn't have. or Connecting Gmail opens soon on this server., this server cannot sign Gmail in yet. If you do not see Add, ask an admin to add Gmail.

What it asks for

• Read mail, labels, drafts and history (gmail.readonly). It does not send.
• Send a message (gmail.send). It does not read mail, and it does not send a draft.
• Change labels, move mail to trash, and work with drafts, including sending a draft (gmail.modify). It does not delete mail forever.
• It does not ask for full mailbox access (https://mail.google.com/).