Overview

Onboarding G Suite (Google Workspace) users to a campaign in XemailCampaign requires administrative configuration inside the Google Admin Console. This process connects your Google Workspace environment with the campaign platform using a secure Client ID integration.

The key step in this process is adding and trusting the campaign application inside Google Admin under API Controls. Without this configuration, users will not be properly authorized to send campaigns through their G Suite accounts.

This guide walks you through the complete setup.

Step 1: Add G Suite inside XemailCampaign

Start inside your XemailCampaign dashboard.

Click Add New in your campaign management interface and select G Suite as your provider. Once selected, the system will generate a Client ID.

Copy this Client ID. You will need it in the Google Admin Console to authorize the application.

Step 2: Configure the Client ID in Google Admin Console

Log in to your Google Admin Console using an administrator account.

Then navigate to:

Security → Access and Data Controls → API Controls → Manage App Access

From there:

1. Click Configure New App

2. Paste the copied Client ID into the input field

3. Search for the application

4. When the campaign app appears (displayed in XML format), select it

This links the campaign platform with your Google Workspace environment.

Step 3: Grant permissions and trust the app

After selecting the campaign application:

• Choose Allow all access

• Mark the app as Trusted

Then click Continue, followed by Finish.

Once completed successfully, the application will appear in your Manage App Access list with trusted status. This confirms that your G Suite environment is authorized to work with XemailCampaign.

Optional: Adjust Google Cloud Session Controls

While not mandatory, adjusting session settings can improve user experience by reducing repeated authentication prompts.

To configure this:

1. Go back to Security → Access and Data Controls

2. Open Google Cloud Session Control

3. Locate the Reauthentication setting

4. Set reauthentication to Never

5. Save your changes

This step prevents frequent reauthentication requests for users interacting with the campaign platform.

What happens after configuration?

Once the app is trusted and access is granted, G Suite users can be successfully onboarded to campaigns within X-Email Campaign.

The integration ensures:

• Secure API access

• Proper sending authorization

• Seamless campaign-user linkage

• Administrative control over permissions

If the app does not appear in trusted apps, recheck the Client ID and confirm it was pasted correctly.

Important notes

• The Client ID integration step is mandatory.

• All permissions must be set to “Allow all access” for proper campaign functionality.

• Session control changes are optional but recommended for smoother onboarding.

• Only Google Admin users can complete this setup.

Final summary

Onboarding G Suite users requires copying the Client ID from XemailCampaign and configuring it inside Google Admin under API Controls. Once the app is trusted and access permissions are granted, users can be fully integrated into campaigns without authentication conflicts.

This ensures secure, controlled, and reliable campaign execution within your Google Workspace environment.