MembershipsMember

Update Member

Update the details of an existing member. This endpoint is used when a member’s information needs to be changed, such as updating their contact details, name, or personal information.

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

memberIdUUIDRequired

Unique identifier for a member.

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

x-api-versiondateOptional

Used for API versioning. More details.

Query parameters

allowMergeOnConflictintegerOptional

Determines how the system should handle member uniqueness conflicts when adding or updating a member. This setting enforces community rules regarding member duplication and allows for automated resolution through member merging.

Options:

  • 0 (default): Do not merge.

    • If a member conflict is detected (i.e., another member exists that violates uniqueness rules), the request will be rejected with an error indicating a member conflict.
    • This ensures no changes are made to existing members and prevents unintended merges.

  • 1 (allow merge): Merge members according to the community’s uniqueness configuration.

    • The member specified in the request (being added or updated) will take precedence.
    • All other conflicting members will be deleted and their associations (e.g., memberships, cards) will be transferred to the surviving member.
    • Merging occurs only if the community setup explicitly permits member merging for the detected conflict scenario.
    • No merge will occur if the community configuration disallows merging, even if this parameter is set to 1.

Important Notes:

  • Member merges are irreversible. Deleted members cannot be recovered after a successful merge.
  • Transferred associations include memberships, cards and other data linked to the conflicting members.
  • If no conflicts are found, setting this parameter has no effect.

Request

This endpoint expects an object.
memberobjectRequired

The MemberEntityRequest defines the basic properties required to create or update a Member.

Response

This endpoint returns an object.
memberobject

The MemberEntityResponse extends the MemberEntityRequest and includes additional properties such as the member’s ID, membership number, and blocked status. This DTO is used when returning a member’s details.