Actions14
- Business Actions
- Campaign Claim Actions
- Files Actions
- Redemption Actions
- Token Actions
- User Actions
User → Create or Update
AI-generatedSummary
Creates a new PERS user or updates an existing one by sending a POST to the PERS API /users endpoint with the email and any optional profile fields.
Inputs
- email — User email address. Not marked required in the UI, but it is the main identifier sent in the body. Empty values are omitted from the request.
- additionalFields — Optional collection of fields merged into the request body: Custom Data (JSON), External ID, First Name, Last Name, Google Account Name, Instagram Account ID, Is Active (boolean, default true), and Public Profile (JSON).
Output shape
One output item per input item. Its json is the PERS API response body for the created or updated user, paired to the input item.
Requires the persApi credential, which supplies the base URL. The source doesn't show the exact response schema. With Continue On Fail enabled, a failed item returns json {error: message} instead of stopping the workflow. The create-vs-update decision is made server-side, and the node doesn't say which key (email or external ID) is used to match an existing user.
Examples
Example 1: Sync a new signup from a form into PERS
Set Email to {{$json.email}}. Under Additional Fields, add First Name and Last Name from the form data.
Example 2: Link a CRM user to a PERS account and deactivate them
Set Email, then add External ID with the CRM ID and set Is Active to false.
Example 3: Store custom attributes on a user
Set Email, then add Custom Data as JSON, e.g. {"tier":"gold"}, and optionally Public Profile JSON.