HUhubspot
Basic

Add memberships

Changed on

Add memberships to a specified list in your HubSpot account. This endpoint allows you to add multiple memberships to a list identified by the listId. It is useful for managing list memberships in bulk, ensuring that the specified records are included in the list.

put/crm/lists/2026-09/{listId}/memberships/add

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/{listId}/memberships/add
  • Auth
    • OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.write, crm.segments.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write, crm.lists.read
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.segments.read, crm.segments.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read, crm.segments.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: crm.lists.read, crm.lists.write
    • or OAuth 2
      Authorization code: https://app.hubspot.com/oauth/authorize
      Token URL: https://api.hubapi.com/oauth/v1/token scopes: cms.membership.access_groups.write, crm.segments.read

Path parameters

listIdstring required

The unique identifier of the list to which memberships will be added.

Request body

string[] required

Response

successful operation

recordIdsMissingstring[] required

An array of strings representing the IDs of records that were not found or could not be processed during the update.

recordIdsRemovedstring[] required

An array of strings representing the IDs of records that were successfully removed from the list.

recordsIdsAddedstring[] required

An array of strings representing the IDs of records that were successfully added to the list.

Changes

  • 2026-09e1dd745172d1Revision changes
    • info

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

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2

  • 2026-096d0e6dc36ca0Revision changes
    • info

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

    • info

      the security scope cms.membership.access_groups.write was removed from the endpoint's security scheme oauth2