App installation status changed

Event Group	Event Identification
apps	apps/installed_uninstalled

Occurs whenever an app is installed or uninstalled in the store.

Request Headers

X-Shopline-Topic string required

The unique identifier for the event.

Example: orders/edited
X-Shopline-Hmac-Sha256 string required

The signature of the request. Upon receiving the request, you must verify the signature to confirm the authenticity and integrity of the data.

Example: XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM=
X-Shopline-Shop-Domain string required

The store domain.

Example: example.myshopline.com
X-Shopline-Shop-Id string required

The store ID.

Example: 1610418123456
X-Shopline-Merchant-Id string required

The merchant ID.

Example: 2000001234
X-Shopline-API-Version string required

The API version.

Example: v20250601
X-Shopline-Webhook-Id string required

The ID of this Webhook event.

Example: b54557e48a5fbf7d70bcd043

Request Body

appkey string

The globally unique identifier for the app.
Example: 35f91ba37b941e6ce5fcc67975ab7aafb0a12345
country_code string

The ISO 3166-1 standard code for the country or region where the store is located.
Example: US
created_at string

The exact date and time when the event occurred. Format: ISO 8601. The time zone corresponds to the store's time zone.

note
The created_at and timestamp fields represent the same moment in time to meet different developer needs.
Example: 2024-04-01T14:01:23+08:00
handle string

The store's unique identifier in SHOPLINE, corresponding to the {handle} part of the domain name {handle}.myshopline.com.
Example: smartstore
merchant_id string

The global unique identifier for the merchant.
Example: 2000001234
name string

The current display name of the store (modifiable by the merchant).
Example: SHOPLINE Store
operate string
The type of operation being performed. For example:
- INSTALL: App installation
- UNINSTALL: App uninstallation
store_id string

The global unique identifier for the store.
Example: 1610418123456
timestamp long

The time when the event occurred, in the format of a 13-digit milliseconds timestamp.

note
The created_at and timestamp fields represent the same moment in time to meet different developer needs.
Example: 1293941471000
timezone string
The IANA time zone identifier used by the store.

For example:
- America/New_York: Eastern Time (US)
- Asia/Tokyo: Japan Standard Time

Status Codes

After receiving a webhook notification from SHOPLINE, you must respond with the following format:

HTTP/1.1 200 OK

For more information about how to subscribe to webhooks and webhook response rules, refer to Webhook overview.

Was this article helpful to you?

SHOPLINE

Legal