Skip to content
Tiketti Docs

Gmail Setup

Connect your Gmail or Google Workspace email to automatically create tickets from incoming messages.

Prerequisites

  • A Gmail or Google Workspace email account
  • Admin access to your Tiketti organization

Personal Gmail accounts can connect directly using Google’s OAuth flow.

Connection Steps

  1. Navigate to mailbox settings

    Go to Settings → Mailboxes in your Tiketti dashboard.

  2. Add a new mailbox

    Click Add Mailbox and select Gmail / Google Workspace.

  3. Authorize with Google

    Click Connect with Google. You’ll be redirected to Google’s sign-in page.

  4. Grant permissions

    Review the permissions Tiketti requests:

    • Read emails: To fetch incoming messages
    • Send emails: To send replies on your behalf
    • Manage labels: To mark processed emails (optional)

    Click Allow to grant access.

  5. Configure mailbox options

    After connecting, configure:

    • Display name: How the mailbox appears in Tiketti
    • Sync folder: Usually “INBOX”
    • Auto-archive: Move processed emails to a folder

  6. Test the connection

    Click Test Connection to verify everything works.

Permissions Explained

PermissionWhy It’s Needed
gmail.readonlyRead incoming emails to create tickets
gmail.sendSend replies to customers
gmail.modifyMark emails as read, move to folders

Google Workspace Setup

For Google Workspace organizations, you may need to:

Option 1: User-level Authorization

Each user connects their own mailbox. No admin setup required.

Option 2: Domain-wide Delegation (Advanced)

For centralized control, Workspace admins can set up domain-wide delegation:

  1. Go to Google Admin Console → Security → API Controls
  2. Click Manage Domain Wide Delegation
  3. Add Tiketti’s client ID with the required scopes
  4. Users can then connect without individual authorization prompts

Troubleshooting

”Access Denied” Error

  • Ensure you’re signing in with the correct Google account
  • Check if your Workspace admin has blocked third-party apps
  • Try disconnecting and reconnecting the mailbox

Emails Not Syncing

  • Verify the mailbox is enabled in Tiketti settings
  • Check the sync folder is set correctly (usually “INBOX”)
  • Trigger a manual sync from mailbox settings

”Token Expired” Error

OAuth tokens expire periodically. Tiketti refreshes them automatically, but if you see this error:

  1. Go to Settings → Mailboxes
  2. Click Reconnect on the affected mailbox
  3. Complete the OAuth flow again

Security Best Practices

  • Use a dedicated support email rather than personal accounts
  • Regularly review connected apps in your Google Account settings
  • Consider using Google Workspace for audit logging

Next Steps