PERS icon

PERS

Interact with the PERS Loyalty API

Actions14

Business → Add Member

AI-generated

Summary

Adds an existing user to a PERS business with a chosen role by sending a POST to /businesses/{businessId}/members.

Inputs

  • Business ID (required) — ID of the business to add the member to. Inserted into the request URL path.
  • User ID (required) — UUID of the user to add (not an email). Sent as userId in the request body.
  • Role (required) — Role to assign: Owner, Admin, Editor or Viewer (default Viewer). Sent as role in the body; the API derives permissions from the role.

Output shape

One output item per input item, containing the JSON response returned by the PERS API for the membership creation.

The response schema is not defined in the node; it is whatever the API returns. Each input item triggers its own request. With 'Continue On Fail' enabled, failures are returned as an item with an error message instead of stopping the workflow. Authenticates with the persApi credential.

Examples

Example 1: Give a newly onboarded staff member read-only access to a business.

Business ID = the business UUID, User ID = the user's UUID, Role = Viewer.

Example 2: Promote a partner manager to administer a business.

Business ID and User ID set from previous node output via expressions, Role = Admin.

Links

Discussion