API Limits

  • You may use up to 200 distinct user attribute names per app.
  • You may use up to 500 event names per app.
  • You may use up to 500 state names per app.
  • You may use up to 200 distinct parameter names across all events and states per app.
  • You may have up to 1500 events per session.
  • You may have up to 1500 states per session.
  • By default, apps cannot use the API to send us historical data. Contact us if you need to do so.
  • Naming rules for events, states, user attributes, and parameters:
    • Length must be greater than 0 and less than 140 characters.
    • Must not start with a period (.) or hyphen (-).
    • Must not end with a forward slash (/).
    • Must not contain commas (,), vertical pipes (|), double quotes ("), tabs, newlines, or return characters.
    • Must not be numeric.
  • Naming rules for variables and message arguments:
    • Dots within names (.) indicate grouping. Objective-C macros use _ instead of .
    • Dots, square brackets, parentheses, and backslashes [].()\ that should appear in the name must be escaped with a leading backslash. Dots used for grouping should not be escaped.
  • User IDs and device IDs must be at most 400 characters.