---
updatedAt: 2026-03-01T18:45:23.000Z
agentTools:
  siteIndex: https://techdocs.akamai.com/llms.txt
  projectIndex: https://techdocs.akamai.com/network-lists/llms.txt
---

# Subscribe to network lists

Specifies a set of email addresses to inform Control Center account recipients about changes to a set of network lists.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Notifications",
    "version": "2"
  },
  "servers": [
    {
      "url": "https://{hostname}/network-list/v2"
    }
  ],
  "paths": {
    "/notifications/subscribe": {
      "post": {
        "operationId": "post-notifications-subscribe",
        "summary": "Subscribe to network lists",
        "description": "Specifies a set of email addresses to inform Control Center account recipients about changes to a set of network lists. \n",
        "requestBody": {
          "content": {
            "application/json": {
              "example": {
                "recipients": [
                  "it-team@mycompany.com",
                  "security-team@mycompany.com"
                ],
                "uniqueIds": [
                  "32055_REPUTATIONWHITELISTDONO",
                  "365_AKAMAITOREXITNODES"
                ]
              },
              "schema": {
                "description": "Controls who is notified about changes to a set of network lists.\n",
                "properties": {
                  "recipients": {
                    "description": "Specifies the full set of email addresses, at least one, that receive notifications about any changes to the network lists specified in `uniqueIds`.\n",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 1,
                    "type": "array",
                    "uniqueItems": true
                  },
                  "uniqueIds": {
                    "description": "Specifies the full set of network list identifiers, at least one, the `recipients` are notified about.\n",
                    "items": {
                      "type": "string"
                    },
                    "minItems": 1,
                    "type": "array",
                    "uniqueItems": true
                  }
                },
                "required": [
                  "recipients",
                  "uniqueIds"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "204": {
            "description": "Subscribed successfully. It also returns a 204 if request specifies users not in Control Center.\n"
          },
          "400": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "properties": {
                    "detail": {
                      "description": "Detailed error message provided by the server.\n",
                      "type": "string"
                    },
                    "errors": {
                      "items": {
                        "properties": {
                          "detail": {
                            "description": "Detailed error message provided by the server.\n",
                            "type": "string"
                          },
                          "fieldErrors": {
                            "additionalProperties": {
                              "type": "string"
                            },
                            "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.\n",
                            "type": "object"
                          },
                          "instance": {
                            "description": "Referencable URL for this error occurrence.\n",
                            "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749",
                            "type": "string"
                          },
                          "status": {
                            "description": "HTTP status code.\n",
                            "example": 404,
                            "type": "integer"
                          },
                          "title": {
                            "description": "Title for the error.\n",
                            "example": "Not Found",
                            "type": "string"
                          },
                          "type": {
                            "description": "URL for the error type.\n",
                            "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND",
                            "type": "string"
                          }
                        },
                        "required": [
                          "type",
                          "status",
                          "title"
                        ],
                        "type": "object"
                      },
                      "type": "array"
                    },
                    "fieldErrors": {
                      "additionalProperties": {
                        "type": "string"
                      },
                      "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.\n",
                      "type": "object"
                    },
                    "instance": {
                      "description": "Referencable URL for this error occurrence.\n",
                      "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749",
                      "type": "string"
                    },
                    "status": {
                      "description": "HTTP status code.\n",
                      "example": 404,
                      "type": "integer"
                    },
                    "title": {
                      "description": "Title for the error.\n",
                      "example": "Not Found",
                      "type": "string"
                    },
                    "type": {
                      "description": "URL for the error type.\n",
                      "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND",
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "status",
                    "title"
                  ],
                  "type": "object"
                }
              }
            },
            "description": "Incorrect client input. See the field errors provided in the response for more information.  This error may also be returned in place of a 404 if a URL parameter was provided in an incorrect format.\n"
          },
          "404": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/paths/~1notifications~1subscribe/post/responses/400/content/application~1problem%2Bjson/schema"
                }
              }
            },
            "description": "Incorrect URL. Check that the network list ID and other URL parameters are valid.\n"
          },
          "500": {
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/paths/~1notifications~1subscribe/post/responses/400/content/application~1problem%2Bjson/schema"
                }
              }
            },
            "description": "We encountered an unexpected issue while processing your request. Please follow the advice provided in the message.\n"
          }
        }
      }
    }
  },
  "x-readme": {
    "samples-languages": [
      "curl",
      "python",
      "node"
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "externalDocs": {
    "url": "https://techdocs.akamai.com/network-lists/reference",
    "description": "See documention for Akamai's Network Lists API"
  }
}
```