Data-driven automation messaging for growth and retention.


Lumen-go client library allows you to seamlessly identify and track user attributes and events on your app. Plus other perks.


  • Identify users
  • Track user events
  • Update user properties

Getting started

  • Setup your Lumen account.

  • Retrieve your API key.

Follow the steps below to retrieve your api key.

  • Log in to your lumen dashboard.
  • Navigate to Settings
  • Select the API Key tab to view and copy your key.
  • Install the package
go get


Import the package

import (

Initialize the package

const LumenApiKey = "<< your-api-key >>";

lumen := lumengo.NewLumengo(LumenApiKey)


Identify a user

	data := lumengo.IdentifyParams{
		Email:     "[email protected]", // required
		FirstName: "Gopher",
		LastName:  "Basit",

    err := lumen.Identify("<< user-identifier >>", data)

	if err != nil {
		return err

Track an event

After identifying users, you can now capture their actions like “Product Clicked” or “Product Viewed” with other custom properties.

 	properties := map[string]interface{}{
		"productId": 100023449,

	err := lumen.Track("<< user-identifier >>", "<< event-name >>", params)

	if err != nil {
		return err


  1. Fork it
  2. Clone your fork (git clone [email protected]:MY_USERNAME/lumen-go.git && cd lumen-go)
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'feat: Added some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create new Pull Request


View Github