HUhubspot
Basic

Add memberships

Changed on

Add memberships to a specified list from another source list. This operation is useful for consolidating list memberships by transferring members from one list to another. The endpoint does not return any content upon successful execution.

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

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/crm/lists/2026-09/{listId}/memberships/add-from/{sourceListId}
  • 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 target list to which memberships will be added.

sourceListIdstring required

The unique identifier of the source list from which memberships will be transferred.

Response

No content

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