HUhubspot
Users

Removes a user

Changed on

Removes a user identified by userId. userId refers to the user's ID by default, or optionally email as specified by the IdProperty query param.

delete/settings/users/2026-09/{userId}

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/settings/users/2026-09/{userId}
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: settings.users.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.objects.users.write

Path parameters

userIdstring required

The unique identifier of the user to delete.

Query parameters

idProperty'EMAIL' | 'USER_ID'

Specifies the property to identify the user. Valid values are 'USER_ID' or 'EMAIL'.

Response

No content

Changes

  • 2026-099aa42e094343Revision changes
    • info

      the security scope settings.users.write was added to the endpoint's security scheme oauth2

    • info

      the security scope crm.objects.users.write was removed from the endpoint's security scheme oauth2

  • 2026-091ec62479c06aRevision changes
    • info

      the security scope crm.objects.users.write was added to the endpoint's security scheme oauth2

    • info

      the security scope settings.users.write was removed from the endpoint's security scheme oauth2