<aside> 💡 We offer free concierge integration calls for customers on any of our paid plans. Feel free to contact us if you would like us to take care of integrating Somma into your system.

</aside>

In order to get user data into Somma we provide a public API (and a JavaScript wrapper around our API) that our customers can use to keep track of their users' properties & events. This page outlines how to use both the API and the JavaScript wrapper.

Getting started

Before any request can be made to the API, you'll need to get a project token which serves as a public identifier for your project. You can get your project token by following these instructions:

Tracking events

Somma lets you track any sort of events that occur in your web application or website. These are generally user triggered actions like clicking a button or submitting a form. We recommend you have a standard naming convention for your events as well as as their properties as explained in this article.

Identifying users

When a user signs up or logs in to your web application, you'll have to identify that user so we can associate subsequent events and properties to that user. In order to identify a user, you'll need to provide a unique identifier for each user, this could be an email address or their id in your database.

Feel free to contact our support team if you need help setting up tracking with Somma.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/9f147d6d-a907-4e61-8772-583965edebe4/Untitled.png