Assign person to group

Use case

Here we will review how to assign a person to the customer group. Let us assign a private person, Trevor Tuum, to a business customer group.

Use case data	API parameters with values
A private person with personId: ID-3392	...persons/ID-3392/person-groups
A customer group for business customers	"personGroupCode": "BUSINESS"

Sample API cal

To assign a person to the customer group, make the following API call.

https://person-api.sandbox.tuumplatform.com/api/v2/persons/ID-3392/person-groups

To learn more about the assign person to group endpoint, check the Tuum developer portal.

Sample request

Below is the example body request of the API call for assigning a person to the group.

JSON

{
  "personGroupCode": "BUSINESS"
}

cURL

Sample response

Here you find an example response body to the API call above.

Response

{
    "errors": null,
    "validationErrors": null,
    "data": {
        "personGroupId": "ID-1489",
        "personId": "ID-3392",
        "personGroupCode": "BUSINESS",
        "validityRange": {
            "endTime": null,
            "startTime": "2023-06-21T20:48:57.250757Z"
        }
    }
}

Result

The user ID-3392 is assigned to the BUSINESS customer group.