> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# appmixer.googleAds.core.RemoveUserFromUserList

- Component: `appmixer.googleAds.core.RemoveUserFromUserList`
- Kind: Action
- Version: 1.0.0
- Visibility: Public
- Connector: [appmixer.googleAds 1.3.3](https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3.md)
- Component page: <https://connectors.appmixer.com/connector/appmixer.googleAds/1.3.3/component/appmixer.googleAds.core.RemoveUserFromUserList>

Removes a single user from a Customer Match user list via UserDataService.UploadUserData. Best for sporadic, real-time updates (e.g. CRM webhook). Limit: 1 user per call. Note: updates do not appear in the Google Ads UI upload history.

## Input ports

### Port `in`

| Field | Type | Description |
| --- | --- | --- |
| Customer ID (`customerId`) | text | - |
| Login Customer ID (`loginCustomerId`) | text | The Google Ads Manager Account (MCC) ID. Required when accessing accounts managed through an MCC hierarchy. Format: 10-digit number, e.g. 1234567890. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#login-customer-id |
| User List ID (`userListId`) | text | Numeric ID of the Customer Match user list. Use either User List ID or User List Resource Name. |
| User List Resource Name (`userListResourceName`) | text | Full resource name, e.g. customers/123/userLists/456. Use either this or User List ID. |
| Email (`email`) | text | Email address of the user. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId. |
| Phone Number (`phoneNumber`) | text | Phone number in E.164 format (e.g., +1234567890). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId. |
| First Name (`firstName`) | text | First name. Use with lastName and countryCode for address-based matching. |
| Last Name (`lastName`) | text | Last name. Use with firstName and countryCode for address-based matching. |
| Country Code (`countryCode`) | text | 2-letter ISO-3166-1 alpha-2 country code (e.g., US, CA, GB). Use with firstName and lastName for address-based matching. |
| Postal Code (`postalCode`) | text | Postal/ZIP code. Optional with address-based matching. |
| Mobile Device ID (`mobileId`) | text | Mobile device ID (IDFA for iOS or Google Advertising ID for Android). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId. |
| Third Party User ID (`thirdPartyUserId`) | text | Advertiser-assigned user ID. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId. |
| Ad User Data Consent (`adUserDataConsent`) | select | User consent status for ad user data. Optional. |
| Ad Personalization Consent (`adPersonalizationConsent`) | select | User consent status for ad personalization. Optional. |

## Output ports

### Port `out`

| Field | Type | Description |
| --- | --- | --- |
| Received Operations Count (`receivedOperationsCount`) | integer | - |
| Upload Date Time (`uploadDateTime`) | string | - |
| User List Resource Name (`userListResourceName`) | string | - |

## Full metadata (component.json)

```json
{
  "name": "appmixer.googleAds.core.RemoveUserFromUserList",
  "description": "Removes a single user from a Customer Match user list via UserDataService.UploadUserData. Best for sporadic, real-time updates (e.g. CRM webhook). Limit: 1 user per call. Note: updates do not appear in the Google Ads UI upload history.",
  "author": "Appmixer <info@appmixer.com>",
  "version": "1.0.0",
  "auth": {
    "service": "appmixer:googleAds",
    "scope": [
      "https://www.googleapis.com/auth/adwords"
    ]
  },
  "quota": {
    "manager": "appmixer:googleAds",
    "resources": "requests"
  },
  "inPorts": [
    {
      "name": "in",
      "schema": {
        "type": "object",
        "properties": {
          "customerId": {
            "type": "string"
          },
          "loginCustomerId": {
            "type": "string"
          },
          "userListId": {
            "type": "string"
          },
          "userListResourceName": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          },
          "firstName": {
            "type": "string"
          },
          "lastName": {
            "type": "string"
          },
          "countryCode": {
            "type": "string"
          },
          "postalCode": {
            "type": "string"
          },
          "mobileId": {
            "type": "string"
          },
          "thirdPartyUserId": {
            "type": "string"
          },
          "adUserDataConsent": {
            "type": "string"
          },
          "adPersonalizationConsent": {
            "type": "string"
          }
        },
        "required": [
          "customerId"
        ]
      },
      "inspector": {
        "inputs": {
          "customerId": {
            "type": "text",
            "label": "Customer ID",
            "index": 1
          },
          "loginCustomerId": {
            "type": "text",
            "label": "Login Customer ID",
            "tooltip": "The Google Ads Manager Account (MCC) ID. Required when accessing accounts managed through an MCC hierarchy. Format: 10-digit number, e.g. 1234567890. See https://developers.google.com/google-ads/api/docs/concepts/call-structure#login-customer-id",
            "index": 2
          },
          "userListId": {
            "type": "text",
            "label": "User List ID",
            "tooltip": "Numeric ID of the Customer Match user list. Use either User List ID or User List Resource Name.",
            "index": 3
          },
          "userListResourceName": {
            "type": "text",
            "label": "User List Resource Name",
            "tooltip": "Full resource name, e.g. customers/123/userLists/456. Use either this or User List ID.",
            "index": 4
          },
          "email": {
            "type": "text",
            "label": "Email",
            "tooltip": "Email address of the user. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.",
            "index": 5
          },
          "phoneNumber": {
            "type": "text",
            "label": "Phone Number",
            "tooltip": "Phone number in E.164 format (e.g., +1234567890). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.",
            "index": 6
          },
          "firstName": {
            "type": "text",
            "label": "First Name",
            "tooltip": "First name. Use with lastName and countryCode for address-based matching.",
            "index": 7
          },
          "lastName": {
            "type": "text",
            "label": "Last Name",
            "tooltip": "Last name. Use with firstName and countryCode for address-based matching.",
            "index": 8
          },
          "countryCode": {
            "type": "text",
            "label": "Country Code",
            "tooltip": "2-letter ISO-3166-1 alpha-2 country code (e.g., US, CA, GB). Use with firstName and lastName for address-based matching.",
            "index": 9
          },
          "postalCode": {
            "type": "text",
            "label": "Postal Code",
            "tooltip": "Postal/ZIP code. Optional with address-based matching.",
            "index": 10
          },
          "mobileId": {
            "type": "text",
            "label": "Mobile Device ID",
            "tooltip": "Mobile device ID (IDFA for iOS or Google Advertising ID for Android). Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.",
            "index": 11
          },
          "thirdPartyUserId": {
            "type": "text",
            "label": "Third Party User ID",
            "tooltip": "Advertiser-assigned user ID. Provide either email OR phone OR (firstName + lastName + countryCode) OR mobileId OR thirdPartyUserId.",
            "index": 12
          },
          "adUserDataConsent": {
            "type": "select",
            "label": "Ad User Data Consent",
            "tooltip": "User consent status for ad user data. Optional.",
            "index": 13,
            "options": [
              {
                "label": "Unspecified",
                "value": "UNSPECIFIED"
              },
              {
                "label": "Unknown",
                "value": "UNKNOWN"
              },
              {
                "label": "Granted",
                "value": "GRANTED"
              },
              {
                "label": "Denied",
                "value": "DENIED"
              }
            ]
          },
          "adPersonalizationConsent": {
            "type": "select",
            "label": "Ad Personalization Consent",
            "tooltip": "User consent status for ad personalization. Optional.",
            "index": 14,
            "options": [
              {
                "label": "Unspecified",
                "value": "UNSPECIFIED"
              },
              {
                "label": "Unknown",
                "value": "UNKNOWN"
              },
              {
                "label": "Granted",
                "value": "GRANTED"
              },
              {
                "label": "Denied",
                "value": "DENIED"
              }
            ]
          }
        }
      }
    }
  ],
  "outPorts": [
    {
      "name": "out",
      "schema": {
        "type": "object",
        "example": {
          "receivedOperationsCount": 1,
          "uploadDateTime": "2024-03-15 10:30:00",
          "userListResourceName": "customers/1234567890/userLists/9876543210"
        },
        "properties": {
          "receivedOperationsCount": {
            "type": "integer",
            "title": "Received Operations Count"
          },
          "uploadDateTime": {
            "type": "string",
            "title": "Upload Date Time"
          },
          "userListResourceName": {
            "type": "string",
            "title": "User List Resource Name"
          }
        }
      }
    }
  ],
  "icon": "(data URI omitted)"
}
```
