> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameball.co/llms.txt
> Use this file to discover all available pages before exploring further.

# How Do I Create and Send Events to Gameball?

> Configure and add the events you send to Gameball automatically through your Admin Settings.

## Plan Availability

<Tabs>
  <Tab title="E-commerce Platforms">
    | Platform | Plan |
    | -------- | ---- |
    | Shopify  | Guru |
    | Salla    | Guru |
  </Tab>

  <Tab title="Custom Integrations">
    | Integration | Plan |
    | ----------- | ---- |
    | Custom      | All  |
  </Tab>
</Tabs>

***

## Overview

Events are the actions performed by your customers on your platform. Your platform should fire signals to Gameball when important events occur. In other words, Gameball should be notified when customers perform certain actions or sequences of actions on your platform. [Learn more](https://developer.gameball.co/rest-api/events)

To configure these events on the **Gameball dashboard**, go to **Settings > Admin Settings > Integrations: Events**.

<Frame>
  <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/events-settings.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=82ba5c90ba3d56233adfa2a5a94f6a98" alt="Events Settings" width="1416" height="753" data-path="images/product-docs/admin-settings/events-settings.png" />
</Frame>

On the events page, you can find all events sent to Gameball and their details.

***

## Adding Events

Once an event is sent from your platform to Gameball, it automatically appears on the events page. You can edit or delete the event as long as it is not linked to any Gameball configurations. Once an event is linked to a campaign, you will not be able to edit it or delete it unless you unlink it.

You can configure and edit event details before linking an event on the Gameball dashboard. Here is a brief description of each field:

<AccordionGroup>
  <Accordion title="Event Label" icon="tag">
    The event name as sent from your platform.
  </Accordion>

  <Accordion title="Display Name" icon="pen">
    A relevant event name as chosen by you for display in the dashboard.
  </Accordion>

  <Accordion title="Key" icon="key">
    Includes two variables: the key name and the data type for the key.
  </Accordion>
</AccordionGroup>

<Frame>
  <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/events-configuration.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=24e87d8069895f18814df6eb635af821" alt="Events Configuration" width="664" height="672" data-path="images/product-docs/admin-settings/events-configuration.png" />
</Frame>

***

## Enable and Disable Internal Events

<Frame>
  <img src="https://mintcdn.com/gameball/uEA80o39LYM8icFj/images/product-docs/admin-settings/internal-events.png?fit=max&auto=format&n=uEA80o39LYM8icFj&q=85&s=fa0cb26ec0c7a2935fd83849f2a4792b" alt="Internal Events" width="1796" height="742" data-path="images/product-docs/admin-settings/internal-events.png" />
</Frame>

You have the ability to **enable or disable the internal events** that Gameball automatically fires (such as `place_order`, `view_product`, `order_refunded`, `add_to_cart`, etc.).

### Why This Matters

This gives you **complete control** over the events you track and process, allowing you to:

* Eliminate unnecessary or duplicate events.
* Customize your tracking to fit your business logic.
* Decide which events should (or shouldn't) be fired to your system.

### Key Details

<CardGroup cols={2}>
  <Card title="Dedicated Settings Page" icon="toggle-on">
    A dedicated settings page lists all auto-fired Gameball events with toggles to enable or disable them individually.
  </Card>

  <Card title="Real-Time Effect" icon="bolt">
    Changes apply in real time — once an event is disabled, it stops being fired immediately.
  </Card>

  <Card title="Disabled Event Behavior" icon="ban">
    When disabled, the event will no longer be sent to your system or used in internal Gameball flows unless you manually fire it.
  </Card>

  <Card title="Access Control" icon="lock">
    Only Admins, Workspace Owners, or Workspace Admins can control event toggles. If custom roles are enabled, this action is assignable.
  </Card>
</CardGroup>

***

## Remarks

<Info>
  The [event and rules](/product-documentation/understanding-your-customers/customer-profile/customer-events) stored for each event must be synced across your mobile and web integrations to provide your customers with a consistent experience.
</Info>

<Warning>
  You can only edit the display name for events linked to configurations on your Gameball dashboard. To make more changes, you must unlink your event from any configurations.
</Warning>

<Tip>
  You can test the events your platform is sending to Gameball through the **Events Log**. [Read more on Events Log](/product-documentation/admin-settings/events-log)
</Tip>

***

## Related Articles

<CardGroup cols={2}>
  <Card title="Understand Your Players' Events" icon="users" href="/product-documentation/understanding-your-customers/customer-profile/customer-events">
    Learn how customer events are tracked and stored in Gameball.
  </Card>

  <Card title="Challenge Event(s) Rule Engine" icon="gears" href="/product-documentation/rewards-campaigns/faqs/using-the-event-engine">
    Understand how the event-based rule engine works for challenges.
  </Card>

  <Card title="Events Log" icon="list-check" href="/product-documentation/admin-settings/events-log">
    Monitor live events being sent from your platform to Gameball.
  </Card>

  <Card title="Using Events on Shopify" icon="shopify" href="/product-documentation/guides-strategies-faqs/shopify-guides/using-events">
    A step-by-step guide to configuring and using events on Shopify.
  </Card>
</CardGroup>