EdgeZones

List available edge zones

Returns the edge zone catalog for webhook delivery. Supports pagination via pageSize and pageToken (see Pagination).

Read-only discovery endpoint - use this to fetch available zone IDs before creating Settings.

Usage

Edge zones control geographic webhook delivery. Twilio selects the best available PoP within the zone at delivery time.

  1. Call this endpoint to get available edge zones and their constituent PoPs
  2. Use the zone id values in Settings.edgeZones when creating Settings

If edge zones are not specified in Settings, webhooks use the home region (same as the processing region).

get/v1/Webhooks/EdgeZones

Request

  • Base URL
    https://webhooks.twilio.com
  • Auth
    HTTP basic

Query parameters

pageSizeinteger

Number of items per page (max 100, reflecting the 50-resource account limit per resource type)

pageTokenstring

Token for pagination

Response

Zone catalog with nested edge location inventory

Example response

{
  "edgeZones": [
    {
      "id": "eu",
      "friendlyName": "European Union",
      "description": "Routes webhooks via European PoPs. Optimal for endpoints in EU member states and surrounding countries.",
      "edgeLocations": [
        {
          "id": "DUB-1",
          "city": "Dublin",
          "country": "IE"
        }
      ]
    }
  ],
  "meta": {
    "key": "items",
    "pageSize": 20,
    "previousToken": "eyJwYWdlIjowLCJxdWVyeSI6ImJvb2tzIn0=",
    "nextToken": "eyJwYWdlIjoyLCJxdWVyeSI6ImJvb2tzIn0="
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.