alternative_distribution_territory_availability_updated

Learn about the ALTERNATIVE_DISTRIBUTION_TERRITORY_AVAILABILITY_UPDATED webhook event. Fired when alternative distribution territory availability changes.

App Store ConnectAlternative Distribution

alternative_distribution_territory_availability_updated

The ALTERNATIVE_DISTRIBUTION_TERRITORY_AVAILABILITY_UPDATED event fires when alternative distribution availability changes for a territory. This is the country-level counterpart to package availability.

When does it fire?

This event triggers when Apple adds, removes, or updates a territory where your app can be distributed through an alternative marketplace.

Payload highlights

The payload includes the app ID and the updated territory availability. Use it to confirm which countries can receive the alternative distribution package.

How Yeethook helps

Territory changes affect who can install your app outside the App Store. Yeethook posts the update to Slack or Discord so legal, product, and release teams see the same change at the same time.

Common use cases

Track which EU territories allow alternative distribution
Alert when a territory is added or removed
Keep marketplace launch plans aligned with Apple's territory list

Example payload

This is the one alternative distribution event with no instance relationship — only marketplaceApp — so there is no package resource to resolve from it. The 27 codes below are the EU member states, which is the full footprint alternative distribution covers.

{
  "data": {
    "type": "alternativeDistributionTerritoryAvailabilityUpdated",
    "id": "33e75449-3196-4bf7-9e69-ca12c3e4f56f",
    "version": 1,
    "attributes": {
      "available": true,
      "territories": [
        "AUT",
        "BEL",
        "BGR",
        "CYP",
        "CZE",
        "DEU",
        "DNK",
        "ESP",
        "EST",
        "FIN",
        "FRA",
        "GRC",
        "HRV",
        "HUN",
        "IRL",
        "ITA",
        "LTU",
        "LUX",
        "LVA",
        "MLT",
        "NLD",
        "POL",
        "PRT",
        "ROU",
        "SVK",
        "SVN",
        "SWE"
      ],
      "appId": "10795421620",
      "timestamp": "2026-09-12T14:55:16.125331Z"
    },
    "relationships": {
      "marketplaceApp": {
        "data": {
          "type": "apps",
          "id": "10737747186"
        },
        "links": {
          "self": "https://api-appstoreconnect.itunes.apple.com/v1/apps/10737747186"
        }
      }
    }
  }
}

What it looks like in Slack

Info

Alternative distribution territory availability updated

Questions about alternative_distribution_territory_availability_updated

Why is there no package ID on this event?

Apple sends a single relationship, marketplaceApp, and omits instance entirely. Availability here is reported at app level, so if you need to know which package version is affected you have to watch ALTERNATIVE_DISTRIBUTION_PACKAGE_AVAILABLE_UPDATED as well.

Which territory codes can show up?

Alpha-3 codes for EU member states — Apple documents the full list of 27, from AUT through SWE. Alternative distribution is an EU-only programme, so the array does not reach beyond that set.

Will Yeethook alert differently when a territory is withdrawn?

No. Every alternative distribution event posts with a globe emoji at info level and a fixed headline, so a withdrawal reads exactly like a package version being created. Route on the event type rather than on severity if the two need different handling.

Learn More

Official Apple documentation:

Get this event in Slack or Discord

Connect Yeethook to receive alternative_distribution_territory_availability_updated notifications in your team's Slack or Discord channels.

Get Started Free