Localytics · Schema

Events API Request V1

A datapoint representing an event submitted to the Localytics Events API

CompanyMarTechMobile AnalyticsPush NotificationsCustomer EngagementMarketing AutomationMobileSegmentationAudiencesEvent IngestiongRPC

Properties

Name Type Description
schema_url string the url of the schema for validating the request
app_uuid string the app's UUID
customer_id string customer id for the user initiating the event
event_name string name of the event
event_time integer time of the event - milliseconds from Unix epoch GMT. Must be after January 1 2010.
uuid string unique identifier for this event, used to deduplicate identical datapoints submitted multiple times. Consists only of alphanumeric characters and dashes.
ltv_change integer lifetime value change effected by this event for this customer in this app
attributes object
View JSON Schema on GitHub

JSON Schema

localytics-events-api-v1-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/schema#",
  "title": "Events API Request V1",
  "description": "A datapoint representing an event submitted to the Localytics Events API",
  "type": "object",
  "properties": {
    "schema_url": {
      "description": "the url of the schema for validating the request",
      "type": "string",
      "pattern": "^https://localytics-files.s3.amazonaws.com/schemas/eventsApi/v1.json$"
    },
    "app_uuid": {
      "description": "the app's UUID",
      "type": "string",
      "minLength": 25,
      "maxLength": 60
    },
    "customer_id": {
      "description": "customer id for the user initiating the event",
      "type": "string",
      "minLength": 1
    },
    "event_name": {
      "description": "name of the event",
      "type": "string",
      "maxLength": 128
    },
    "event_time": {
      "description": "time of the event - milliseconds from Unix epoch GMT. Must be after January 1 2010.",
      "type": "integer",
      "minimum": 1262304000000
    },
    "uuid": {
      "description": "unique identifier for this event, used to deduplicate identical datapoints submitted multiple times. Consists only of alphanumeric characters and dashes.",
      "type": "string",
      "minLength": 16,
      "maxLength": 128,
      "pattern": "^[0-9a-zA-Z\\-]{16,128}$"
    },
    "ltv_change": {
      "description": "lifetime value change effected by this event for this customer in this app",
      "type": "integer"
    },
    "attributes": {
      "type": "object",
      "patternProperties": {
        "^.{1,128}$": {
          "description": "user-defined key/value pairs. Maximum of 50 key/value pairs allowed per distinct event_name across all requests for all time.",
          "type": "string",
          "maxLength": 255
        }
      },
      "maxProperties": 50,
      "additionalProperties": false
    }
  },
  "required": [
    "schema_url",
    "app_uuid",
    "customer_id",
    "event_name",
    "event_time",
    "uuid"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/localytics-events-api-v1"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.