---
title: AppEvent - Partner API
description: An event related to a Shopify app.
api_version: 2025-01
api_name: partner
type: interface
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/partner/2025-01/interfaces/AppEvent'
  md: 'https://shopify.dev/docs/api/partner/2025-01/interfaces/AppEvent.md'
---

# App​Event

interface

An event related to a Shopify app.

## Fields

* app

  [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

  non-null

  A Shopify [app](https://shopify.dev/concepts/apps).

* occurred​At

  [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

  non-null

  The date and time when the event took place.

* shop

  [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

  non-null

  A Shopify shop.

* type

  [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

  non-null

  The type of app event.

***

## Types implemented in

* [Credit​Applied](https://shopify.dev/docs/api/partner/2025-01/objects/CreditApplied)

  OBJECT

  An event that marks that an app credit was applied.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * app​Credit

    [App​Credit!](https://shopify.dev/docs/api/partner/2025-01/objects/AppCredit)

    non-null

    A [credit](https://shopify.dev/docs/admin-api/rest/reference/billing/applicationcredit) issued to a merchant for an app. Merchants are entitled to app credits under certain circumstances, such as when a paid app subscription is downgraded partway through its billing cycle.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Credit​Failed](https://shopify.dev/docs/api/partner/2025-01/objects/CreditFailed)

  OBJECT

  An event that marks that an app credit failed to apply.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * app​Credit

    [App​Credit!](https://shopify.dev/docs/api/partner/2025-01/objects/AppCredit)

    non-null

    A [credit](https://shopify.dev/docs/admin-api/rest/reference/billing/applicationcredit) issued to a merchant for an app. Merchants are entitled to app credits under certain circumstances, such as when a paid app subscription is downgraded partway through its billing cycle.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Credit​Pending](https://shopify.dev/docs/api/partner/2025-01/objects/CreditPending)

  OBJECT

  An event that marks that an app credit is pending.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * app​Credit

    [App​Credit!](https://shopify.dev/docs/api/partner/2025-01/objects/AppCredit)

    non-null

    A [credit](https://shopify.dev/docs/admin-api/rest/reference/billing/applicationcredit) issued to a merchant for an app. Merchants are entitled to app credits under certain circumstances, such as when a paid app subscription is downgraded partway through its billing cycle.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [One​Time​Charge​Accepted](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeAccepted)

  OBJECT

  An event that marks that a one-time app charge was accepted by the merchant.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Purchase​One​Time!](https://shopify.dev/docs/api/partner/2025-01/objects/AppPurchaseOneTime)

    non-null

    A one-time app charge for services and features purchased once by a store. For example, a one-time migration of a merchant's data from one platform to another.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [One​Time​Charge​Activated](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeActivated)

  OBJECT

  An event that marks that a one-time app charge was activated.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Purchase​One​Time!](https://shopify.dev/docs/api/partner/2025-01/objects/AppPurchaseOneTime)

    non-null

    A one-time app charge for services and features purchased once by a store. For example, a one-time migration of a merchant's data from one platform to another.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [One​Time​Charge​Declined](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeDeclined)

  OBJECT

  An event that marks that a one-time app charge was declined by the merchant.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Purchase​One​Time!](https://shopify.dev/docs/api/partner/2025-01/objects/AppPurchaseOneTime)

    non-null

    A one-time app charge for services and features purchased once by a store. For example, a one-time migration of a merchant's data from one platform to another.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [One​Time​Charge​Expired](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeExpired)

  OBJECT

  An event that marks that a one-time app charge expired before the merchant could accept it.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Purchase​One​Time!](https://shopify.dev/docs/api/partner/2025-01/objects/AppPurchaseOneTime)

    non-null

    A one-time app charge for services and features purchased once by a store. For example, a one-time migration of a merchant's data from one platform to another.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Relationship​Deactivated](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipDeactivated)

  OBJECT

  An event that marks that an app was deactivated.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Relationship​Installed](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipInstalled)

  OBJECT

  An event that marks that an app was installed.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Relationship​Reactivated](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipReactivated)

  OBJECT

  An event that marks that an app was reactivated.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Relationship​Uninstalled](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipUninstalled)

  OBJECT

  An event that marks that an app was uninstalled.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * description

    [String](https://shopify.dev/docs/api/partner/2025-01/scalars/String)

    More details from the merchant about why they uninstalled the app.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * reason

    [String](https://shopify.dev/docs/api/partner/2025-01/scalars/String)

    A comma separated list of reasons why the merchant uninstalled the app.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Approaching​Capped​Amount](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionApproachingCappedAmount)

  OBJECT

  An event that marks that a subscription is approaching its capped amount.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Capped​Amount​Updated](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionCappedAmountUpdated)

  OBJECT

  An event that marks that a subscription had its capped amount updated.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Accepted](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeAccepted)

  OBJECT

  An event that marks that a recurring app charge was accepted.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Activated](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeActivated)

  OBJECT

  An event that marks that a recurring app charge was activated.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Canceled](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeCanceled)

  OBJECT

  An event that marks that a recurring app charge was cancelled.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Declined](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeDeclined)

  OBJECT

  An event that marks that a recurring app charge was declined.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Expired](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeExpired)

  OBJECT

  An event that marks that a recurring app charge has expired.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Frozen](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeFrozen)

  OBJECT

  An event that marks that a recurring app charge has been suspended. For example, if a merchant stops paying their bills, or closes their store, then Shopify suspends the recurring app charge.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Subscription​Charge​Unfrozen](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeUnfrozen)

  OBJECT

  An event that marks that a recurring app charge was unfrozen.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Subscription!](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription)

    non-null

    A recurring charge for use of an app, such as a monthly subscription charge.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

* [Usage​Charge​Applied](https://shopify.dev/docs/api/partner/2025-01/objects/UsageChargeApplied)

  OBJECT

  An event that marks that an app usage charge was applied.

  * app

    [App!](https://shopify.dev/docs/api/partner/2025-01/objects/App)

    non-null

    A Shopify [app](https://shopify.dev/concepts/apps).

  * charge

    [App​Usage​Record!](https://shopify.dev/docs/api/partner/2025-01/objects/AppUsageRecord)

    non-null

    An app charge. This charge varies based on how much the merchant uses the app or a service that the app integrates with.

  * occurred​At

    [Date​Time!](https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime)

    non-null

    The date and time when the event took place.

  * shop

    [Shop!](https://shopify.dev/docs/api/partner/2025-01/objects/Shop)

    non-null

    A Shopify shop.

  * type

    [App​Event​Types!](https://shopify.dev/docs/api/partner/2025-01/enums/AppEventTypes)

    non-null

    The type of app event.

***

##### Variables

```json
{
	"app": "",
	"occurredAt": "",
	"shop": "",
	"type": ""
}
```

##### Schema

```graphql
interface AppEvent {
  app: App!
  occurredAt: DateTime!
  shop: Shop!
  type: AppEventTypes!
}
```