HomeGuidesRecipesAPI ReferenceChangelog
GuidesAPI ReferenceCustomer Help CenterLog In


Certain objects in Xola have a metadata parameter. You can use this parameter to attach key-value data to these objects.

Metadata is useful for storing additional, structured information about an object. For example, you could store the customer ID from your CRM system in the Xola User object.


One important limitation of metadata keys is that they cannot contain periods (.). We recommend you use a forward slash (/) to delimit keys.

We also recommend that you namespace your keys by prefixing them with your company name and application name so that your keys do not conflict with any other applications that may utilize metadata. E.g. acme/rocket/my_preference

Objects that support metadata

Currently, the following objects support user-definable metadata:


  • POST /api/users/:id/meta to add metadata. You may pass multiple key-value pairs.
  • DELETE /api/users/:id/meta/:property to remove a single metadata property.

Any metadata present for a user will be returned when fetching a user with the private=true flag.
GET /api/users/:id?private=true