📘 Definition

The "Delete Mobile Device" action allows Google Workspace administrators to remove a registered mobile device from the organization’s device inventory. This action is especially useful for managing mobile device security, such as when a device is lost, stolen, decommissioned, or no longer in use.

By using this action, admins can efficiently maintain up-to-date mobile device records and ensure that outdated or untrusted devices are no longer associated with the organization. It works by using the device’s unique resource ID and supports domain-wide delegation for automated administration at scale.

Example use cases :

🔒 Revoke Access for Lost or Stolen Devices

When an employee reports a lost or stolen mobile device, an admin can use this action to remove the device from Google Workspace, ensuring sensitive organizational data is no longer accessible.

🔄 Clean Up Inactive Devices

Administrators can periodically audit and remove mobile devices that haven't synced in a long time or belong to former employees to maintain a clean and secure device list.

🛑 Offboarding Employees

As part of the offboarding workflow, this action can be used to delete the user's mobile device from the admin console after their account is deactivated.

🧪 Testing Device Management Policies

During testing or QA, IT teams can add and remove devices to validate that mobile device management (MDM) policies are functioning correctly.

Input :

Connection

**(a Google Workspace Administration connection. You need to upload a credential JSON file for a service account with domain-wide delegation)**This field is used to authenticate and authorize the action using a Google Workspace Admin connection. The connection must be set up using a service account that has domain-wide delegation enabled.➡️ Click here for a setup guide.

Admin Email Address

**(Admin's email address)**Enter the email address of a Google Workspace Super Admin. This account will be used to execute the deletion request via the authenticated service account.

User Email

**(The user's email address)**Specify the email address of the user who owns the mobile device you intend to delete. This helps locate the exact user and their associated devices.

Resource ID

**(The unique ID the API service uses to identify the mobile device)**This is a system-generated identifier assigned to the mobile device by the API. You must provide this to uniquely identify and delete the correct device.➡️ You can retrieve this ID using the “List Mobile Devices” action.

Customer ID (Optional)

**(The unique ID for the customer's Google Workspace account. If left empty, the default will be selected)**Enter the customer ID of your Google Workspace account. If you leave this blank, the system will use the default ID linked to the authenticated admin connection.

📘 Example Scenario:

Revoking access for a lost or decommissioned company device

Imagine a company employee has left the organization, and their work phone—previously used to access company emails and data—is no longer in use or has been lost. As an IT admin, you want to ensure that this device can no longer access corporate resources for security and compliance reasons.

To automate this:

You first use the “List Mobile Devices” action to retrieve all registered mobile devices for that user.
You locate the target device and copy its Resource ID.
You then use the “Delete Mobile Device” action, providing:
- The Admin Email Address (a super admin in your domain),
- The User Email (who the device was assigned to),
- The Resource ID of the device,
- And optionally the Customer ID.

Once executed, the mobile device will be removed from the Google Workspace Admin console, revoking its access and management policies.