How do I manage event types?

Last updated: December 19, 2025

Managing Event Types

Overview

Event types are the categories of usage events that you track and bill for in your platform. Examples include "API Calls", "Storage GB", "Hours", etc. Each event type represents a specific metric that you want to measure and charge customers for.

The Event Types management interface allows you to:

  • Create new event types

  • View all event types with search and sorting capabilities

  • Edit existing event type names

  • Delete event types that are no longer needed

  • See which customers are using each event type

  • View the status (Active/Inactive) of each event type

Accessing Event Types Management

  1. Navigate to Usage → Events in the main navigation.

  2. Click the "Manage event types" button in the page header.

    image.png

  3. You'll be taken to the Event Types management page.

    image.png

The Event Types table displays all your event types with the following information:

  1. Event Type: Shows the event type name and its unique ID

  2. Status: Indicates whether the event type is "Active" or "Inactive"

    • Active: The event type is currently being used by at least one customer

    • Inactive: The event type exists but is not currently associated with any customers

  3. Customers: The number of customers currently using this event type

  4. Created: The date and time when the event type was created

  5. Last Updated: The date and time when the event type was last modified

Creating Event Types

Step-by-Step Process

  1. On the Event Types management page, click the "Add event type" button in the header.

    image.png

  2. A modal dialog will appear.

  3. Enter the event type name in the input field.

    image.png

    • Important: Event type names are case-sensitive and must match exactly when uploading usage data

    • Use descriptive names that clearly identify what the event type measures (e.g., "API Calls", "Storage GB", "Bandwidth")

  4. Click "Create" to save the new event type.

    image.png

Important Notes

  • New event types must be mapped to customer Products in or to count toward billing: After creating an event type, you'll need to map it to a customer's Product in order for it to be tracked and applied for billing

  • Event type names are used in CSV uploads: When uploading usage data via CSV, you must use the exact event type name (case-sensitive) in your CSV file

  • Event types are manufacturer-specific: Each event type belongs to your account and is available for all your customers

Editing Event Types

When to Edit

You may want to edit an event type name if:

  • You need to correct a typo

  • You want to rename it for clarity

  • You're standardizing naming conventions across your event types

Step-by-Step Process

  1. Find the event type you want to edit in the table.

  2. Click the Edit icon (pencil) in the row actions.

    image.png

  3. A modal dialog will appear with the current event type name pre-filled.

  4. Modify the name as needed.

  5. Click "Save" to update the event type.

    image.png

Important Notes

  • Updating the name does not impact billing: Changing an event type name will not affect existing invoices or billing calculations

  • Use the new name going forward: After renaming, use the new name in all future usage uploads (CSV files, API calls, etc.)

  • Historical data is preserved: Past usage data will still reference the old name, but new data should use the updated name

Deleting Event Types

When to Delete

You may want to delete an event type if:

  • It was created by mistake

  • It's no longer being used and won't be needed in the future

  • You're cleaning up unused event types

Step-by-Step Process

  1. Find the event type you want to delete in the table.

  2. Click the Delete icon (trash) in the row actions.

    image.png

  3. A confirmation modal will appear asking you to confirm the deletion.

  4. Review the confirmation message.

  5. Click "Confirm" to permanently delete the event type.

    image.png

Important Notes

  • Deletion is permanent: Once deleted, an event type cannot be recovered

  • Check customer associations: Before deleting, verify that no customers are currently using the event type (check the "Customers" column)

  • Only Inactive event types can be deleted: Active event types are linked to products that are actively billing, and therefore cannot be deleted.

  • Historical data: Past usage data associated with the deleted event type will remain in the system but cannot be linked to the deleted event type

CSV Uploads

  1. Match names exactly: When uploading usage via CSV, ensure event type names match exactly (case-sensitive)

  2. Download customer IDs: Use the "Download customer IDs" feature when preparing CSV files to ensure correct customer IDs

  3. Verify before upload: Double-check that all event types in your CSV exist in the system before uploading

Troubleshooting

"Event type does not exist" error in CSV uploads

Problem: Your CSV file references an event type name that doesn't exist in the system.

Solution:

  1. Check the Event Types management page to see all available event types

  2. Verify the event type name in your CSV matches exactly (case-sensitive)

  3. Create the event type if it doesn't exist

  4. Re-upload your CSV file

Can't delete an event type

Problem: You're unable to delete an event type, or it shows as Active.

Solution:

  1. Check the Customers column to see if any customers are using it

  2. Remove the event type from all customer Products first

  3. Wait for the status to change to Inactive

  4. Then delete the event type

Event type shows as Inactive but should be Active

Problem: An event type you expect to be Active shows as Inactive.

Solution:

  1. Verify the event type is mapped to at least one customer's Product

  2. Check that the Product is active and the mapping is correct

  3. The status updates automatically when mappings change

Can't find an event type in the list

Problem: You know an event type exists but can't find it in the table.

Solution:

  1. Use the search box to search by name or ID

  2. Check if you're on the correct page (use pagination if you have many event types)

  3. Verify you're logged into the correct account

  4. Check if the event type was deleted

Need Help?

If you encounter issues not covered in this guide:

  1. Check the error messages in the interface—they provide specific details about what went wrong

  2. Verify your event type names match exactly (case-sensitive) when uploading usage data

  3. Ensure event types are properly mapped to customer Products before expecting them to be Active

  4. Contact support with:

    • The event type name(s) you're working with

    • Screenshots of any error messages

    • Steps you took before encountering the issue