User Group

The new user group (version 2) solves the use cases of both B2B loyalty and B2C loyalty unlike the previous version which was designed for B2C cases. This resource contains APIs to manage user groups.

Response Parameters

ParameterDatatypeDescription
defaultGroupbooleanWhether it is the default group for the customer.
activebooleanStatus of the customer. Internally, it is always true.
resultobjActual response schema.
userIdlongUnique ID of the customer/member.
groupIdintGroup ID to which the customer is added.
defaultGroupbooleanWhether it is a default group for the customer. This will be true for the primary member.
permissionsarrayPermissions of the member.

Status Codes

Error Codes

CodeDescription
403Field {x} is mandatory.
1619Group id {x} is invalid
1620User {x} does not belong to group {y}.
1622Users does not belong to same company.
1623User {x} already present in group {y}.
1624Group transfer not allowed for primary member {x}
1632Group id/externalId/primary userId {x} passed is not valid.
1633Group external Id {x} already exists.
1634Group externalId can't be null
1635Group query param is not passed.
1636Customer is already a member of the group.
1637Primary member exists for the group.
1638Total members in the group reached maximum group capacity {x}.
1639Group max size can not exceed product limit {x}
1640Group max size field should be a positive value.
1641Invalid permission code {x} passed.
1642User is primary member in a different group.
1643Nothing to update in the group
1644Group details not passed.
1645Group details passed are not valid.
8015Customer not found for the given identifiers.
8069Merged customer found.