27 February 2025 (v2.130)

ReachFive v2.130 introduces several improvements and needed bug fixes.

We’re happy to announce that you can now create structured custom fields directly in the console. Another exciting option for customers now is the option to implement on-demand scaling to accommodate high traffic during anticipated periods for your site. You can also now manage MFA credentials from the console. In addition to this, you can now search for users based on third-party grants.

As always, we fixed a few items for you.

Release highlight

Structured custom fields

With the v2.130 release, you can now create structured custom fields, by associating several custom fields to a parent in a JSON object. This means that you can create custom fields whose path is expanded into a JSON object in the API responses.

For full details and instructions, see Custom fields.

Benefits

Improved data organisation
Better scalability for future use cases
Greater flexibility for custom fields, enabling richer metadata storage

Actions

ReachFive Console
- Create structured custom fields
- Search for structured custom fields

API

Add structured custom fields to a user’s profile with /users/:id endpoint

"custom_fields": {
  "has_loyalty_card": true,
  "gaa": {
    "football": "Kerry",
    "hurling": "Clare",
    "watches_weekly": true
  }
}

Retrieve structured custom fields for a user /users/?fields=<field> endpoint
```
GET /api/v2/users?fields=gaa.football == "Kerry"
```

On-demand scaling

Our On-demand scaling feature lets you temporarily scale our authentication infrastructure to handle increased login activity.

It is particularly useful for those of you experiencing predictable traffic surges, such as product launches, seasonal sales, or marketing campaigns, ensuring smooth and uninterrupted authentication for this higher volume of users.

For more details, see On-demand scaling.

Manage MFA credentials from console

You can now manage a user’s MFA credentials directly from the ReachFive Console. This was previously only available through our Management API.

For more, see Manage MFA credentials from console.

Instructions

To manage a user’s MFA credentials from the console:

Log in to your ReachFive Console.
Go to Analytics Profiles.
Click your desired user.
Click the Actions button.
1. Click Edit.
2. Go to the MFA tab.
  
  In the MFA tab, you can remove existing MFA credentials and add email or SMS as an MFA credential.
Don’t forget to Save your input.
- Add MFA credential
- Remove MFA credential

Search for users by grants

You can now search for users by third party grant information including. This includes via the ReachFive Console and the Management API.

client_id: The client_id of the third party grant.
date: The date on which the third party grant was issued.

ReachFive Console
Management API

Use the Filter section on the ReachFive Console when filtering user profiles, or on your export or hook.

2130 export filter grants

Use the filter query parameter with the Management API as shown here.

GET api/v2/users?filter=third_party_grants.client_id==="k6ShTTsHfVE5aXu5uW0i"

Fixes

Item Fixed

The is none of operator for job definitions was briefly not working as expected. This has now been resolved and is working properly again.

✓

You were unable to create a custom field with an existing prefix. This means that if you created the custom field really_awesome, you were unable to create another custom field called really_freaking_awesome. This has been resolved and you can, once again, create custom fields with matching prefixes as expected.

Duplicated custom field names are still prevented.

✓

It was temporarily impossible to create a custom address field with an underscore (custom_field).

✓

There was a small issue retrieving the trusted device cookie for the loginWithPassword method.

✓