Create or Update a Person

Updates a person record for the specified person. If no record of the specified person exists, this route creates a person record.

User Attributes

Attributes are represented in Boomtrain's systems as a set of key:value pairs. Any string can be used as an attribute value.

Note that all user attribute keys will be normalized in the following way:

  1. Leading and trailing whitespace characters will be removed.
  2. Any instances of multiple consecutive whitespace characters will be replaced with a single whitespace character.
  3. Uppercase letters are downcased
  4. Whitespaces are replaced with underscore characters.

This normalization will occur for all keys inside a nested value within that attribute as well.

As an example, the attribute expressed as "My Attribute" will be transformed to my_attribute.

There are a few attribute names that are recognized as standard values:

Attribute Name


first_name OR firstname

The first name of the user.

last_name OR lastname

The last name of the user.


The full name of the user.


The date that a user signed up for your site. Note that this attribute should be specified as an ISO-8601 Timestamp String.

Click Try It! to start a request and see the response here!