---
title: Store Group Events
description: Documentation for store group-related webhook events
sidebar:
  label: Store Group Events
---

This section covers all webhook events related to store groups, including store group updates, deletions, and market changes.

## Event Types

The following store group-related events are available:

- `store_group.update` - Triggered when a store group is created or modified
- `store_group.deleted` - Triggered when a store group is deleted
- `store_group_market.update` - Triggered when a store group's market is updated
- `store_group_market.deleted` - Triggered when a market is removed from a store group

## Store Group Updated Event

The `store_group.update` event is triggered when a store group is created or modified.

### Event Structure

```json
{
  "event_type": "store_group.update",
  "payload": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "slug": "main-store",
    "name": "Main Store",
    "country_of_sale": "US",
    "description": "Primary retail store group",
    "channel_type": "retail",
    "markets": [
      {
        "created": true,
        "country_code": "us",
        "is_tax_included_in_price": true,
        "is_tax_exemption_eligible": false,
        "currency_code": "USD"
      },
      {
        "created": true,
        "country_code": "ca",
        "is_tax_included_in_price": true,
        "is_tax_exemption_eligible": true,
        "currency_code": "CAD"
      }
    ]
  }
}
```

### Field Descriptions

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique identifier for the store group |
| `slug` | string | URL-friendly identifier |
| `name` | string | Display name of the store group |
| `country_of_sale` | string | Primary country of sale |
| `description` | string | Store group description |
| `channel_type` | string | Type of sales channel |
| `markets` | array | Associated markets configuration |

## Store Group Deleted Event

The `store_group.deleted` event is triggered when a store group is removed from the system.

### Event Structure

```json
{
  "event_type": "store_group.deleted",
  "payload": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "slug": "main-store"
  }
}
```

### Field Descriptions

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique identifier of the deleted store group |
| `slug` | string | URL-friendly identifier of the deleted store group |

## Store Group Market Updated Event

The `store_group_market.update` event is triggered when a market within a store group is updated.

### Event Structure

```json
{
  "event_type": "store_group_market.update",
  "payload": {
    "store_group_id": "123e4567-e89b-12d3-a456-426614174000",
    "store_group_slug": "main-store",
    "country_codes": ["us"],
    "currency_code": "USD",
    "is_tax_included_in_price": true,
    "is_tax_exemption_eligible": false,
    "created": true
  }
}
```

### Field Descriptions

| Field | Type | Description |
|-------|------|-------------|
| `store_group_id` | string | ID of the store group |
| `store_group_slug` | string | Slug of the store group |
| `country_code` | string | Two-letter ISO country code |
| `currency_codes` | string array | Array of Three-letter ISO currency code |
| `is_tax_included_in_price` | boolean | Whether prices include tax |
| `is_tax_exemption_eligible` | boolean | Whether tax exemption is available |
| `created` | boolean | Whether this is a new market |

## Store Group Market Deleted Event

The `store_group_market.deleted` event is triggered when a market is removed from a store group.

### Event Structure

```json
{
  "event_type": "store_group_market.deleted",
  "payload": {
    "store_group_id": "123e4567-e89b-12d3-a456-426614174000",
    "store_group_slug": "main-store",
    "country_codes": ["us"]
  }
}
```

### Field Descriptions

| Field | Type | Description |
|-------|------|-------------|
| `store_group_id` | string | ID of the store group |
| `store_group_slug` | string | Slug of the store group |
| `country_codes` | string array | Array Two-letter ISO country code of the removed market |