diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/apimnotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/apimnotifications.json
new file mode 100644
index 000000000000..4dfa5efe25d7
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/apimnotifications.json
@@ -0,0 +1,756 @@
+{
+  "swagger": "2.0",
+  "info": {
+    "title": "ApiManagementClient",
+    "description": "Use these REST APIs for performing operations on who is going to receive notifications associated with your Azure API Management deployment.",
+    "version": "2017-03-01"
+  },
+  "host": "management.azure.com",
+  "schemes": [
+    "https"
+  ],
+  "consumes": [
+    "application/json"
+  ],
+  "produces": [
+    "application/json"
+  ],
+  "security": [
+    {
+      "azure_auth": [
+        "user_impersonation"
+      ]
+    }
+  ],
+  "securityDefinitions": {
+    "azure_auth": {
+      "type": "oauth2",
+      "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize",
+      "flow": "implicit",
+      "description": "Azure Active Directory OAuth2 Flow.",
+      "scopes": {
+        "user_impersonation": "impersonate your user account"
+      }
+    }
+  },
+  "paths": {
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications": {
+      "get": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_ListByService",
+        "description": "Lists a collection of properties defined within a service instance.",
+        "x-ms-examples": {
+          "ApiManagementListNotification": {
+            "$ref": "./examples/ApiManagementListNotifications.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/TopQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SkipQueryParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "A Collection of the Notification for the specified API Management service instance.",
+            "schema": {
+              "$ref": "#/definitions/NotificationCollection"
+            }
+          }
+        },
+        "x-ms-pageable": {
+          "nextLinkName": "nextLink"
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}": {
+      "get": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_Get",
+        "description": "Gets the details of the Notification specified by its identifier.",
+        "x-ms-examples": {
+          "ApiManagementGetNotification": {
+            "$ref": "./examples/ApiManagementGetNotification.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the specified Notification.",
+            "schema": {
+              "$ref": "#/definitions/NotificationContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "Notification_CreateOrUpdate",
+        "description": "Updates an Notification.",
+        "x-ms-examples": {
+          "ApiManagementGetNotification": {
+            "$ref": "./examples/ApiManagementGetNotification.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Notification was successfully updated.",
+            "schema": {
+              "$ref": "#/definitions/NotificationContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers": {
+      "get": {
+        "tags": [
+          "Notification"
+        ],
+        "operationId": "NotificationRecipientUser_ListByNotification",
+        "description": "Gets the list of the Notification Recipient User subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementListNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementListNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the Recipient User collection for the notification.",
+            "schema": {
+              "$ref": "#/definitions/RecipientUserCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientUsers/{uid}": {
+      "head": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_Get",
+        "description": "Determine if the Notification Recipient User is subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementGetNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementGetNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimusers.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The User is subscribed to receive the notification."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_CreateOrUpdate",
+        "description": "Adds the API Management User to the list of Recipients for the Notification.",
+        "x-ms-examples": {
+          "ApiManagementCreateRecipientUser": {
+            "$ref": "./examples/ApiManagementCreateRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimusers.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Recipient User was successfully added to the notification list.",
+            "schema": {
+              "$ref": "#/definitions/RecipientUserContract"
+            }
+          },
+          "200": {
+            "description": "Recipient User is already part of the notification list.",
+            "schema": {
+              "$ref": "#/definitions/RecipientUserContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NotificationRecipientUser"
+        ],
+        "operationId": "NotificationRecipientUser_Delete",
+        "description": "Removes the API Management user from the list of Notification.",
+        "x-ms-examples": {
+          "ApiManagementDeleteNotificationRecipientUser": {
+            "$ref": "./examples/ApiManagementDeleteNotificationRecipientUser.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimusers.json#/parameters/UserIdParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Recipient User was successfully removed from the notification list."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails": {
+      "get": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_ListByNotification",
+        "description": "Gets the list of the Notification Recipient Emails subscribed to a notification.",
+        "x-ms-examples": {
+          "ApiManagementListNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementListNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "The response body contains the Recipient Email collection subscribed to the notification.",
+            "schema": {
+              "$ref": "#/definitions/RecipientEmailCollection"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    },
+    "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/notifications/{notificationName}/recipientEmails/{email}": {
+      "head": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_Get",
+        "description": "Determine if Notification Recipient Email subscribed to the notification.",
+        "x-ms-examples": {
+          "ApiManagementGetNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementGetNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "The Users is subscribed to receive the notification."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "put": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_CreateOrUpdate",
+        "description": "Adds the Email address to the list of Recipients for the Notification.",
+        "x-ms-examples": {
+          "ApiManagementCreateRecipientEmail": {
+            "$ref": "./examples/ApiManagementCreateRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "201": {
+            "description": "Recipient Email was successfully added to the notification list.",
+            "schema": {
+              "$ref": "#/definitions/RecipientEmailContract"
+            }
+          },
+          "200": {
+            "description": "Recipient Email is already part of the notification list.",
+            "schema": {
+              "$ref": "#/definitions/RecipientEmailContract"
+            }
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      },
+      "delete": {
+        "tags": [
+          "NotificationRecipientEmail"
+        ],
+        "operationId": "NotificationRecipientEmail_Delete",
+        "description": "Removes the email from the list of Notification.",
+        "x-ms-examples": {
+          "ApiManagementDeleteNotificationRecipientEmail": {
+            "$ref": "./examples/ApiManagementDeleteNotificationRecipientEmail.json"
+          }
+        },
+        "parameters": [
+          {
+            "$ref": "./apimanagement.json#/parameters/ResourceGroupNameParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ServiceNameParameter"
+          },
+          {
+            "$ref": "#/parameters/NotificationNameParameter"
+          },
+          {
+            "$ref": "#/parameters/EmailParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/ApiVersionParameter"
+          },
+          {
+            "$ref": "./apimanagement.json#/parameters/SubscriptionIdParameter"
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Recipient Email was successfully removed to the notification list."
+          },
+          "default": {
+            "description": "Error response describing why the operation failed.",
+            "schema": {
+              "$ref": "./apimanagement.json#/definitions/ErrorResponse"
+            }
+          }
+        }
+      }
+    }
+  },
+  "definitions": {
+    "NotificationCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/NotificationContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Notification list representation."
+    },
+    "NotificationContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/NotificationContractProperties",
+          "description": "Notification entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Notification details."
+    },
+    "NotificationContractProperties": {
+      "properties": {
+        "title": {
+          "type": "string",
+          "description": "Title of the Notification.",
+          "minLength": 1,
+          "maxLength": 1000
+        },
+        "description": {
+          "type": "string",
+          "description": "Description of the Notification."
+        },
+        "recipients": {
+          "$ref": "#/definitions/RecipientsContractProperties",
+          "description": "Recipient Parameter values."
+        }
+      },
+      "required": [
+        "title"
+      ],
+      "description": "Notification Contract properties."
+    },
+    "RecipientsContractProperties": {
+      "properties": {
+        "emails": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of Emails subscribed for the notification."
+        },
+        "users": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          },
+          "description": "List of Users subscribed for the notification."
+        }
+      },
+      "description": "Notification Parameter contract."
+    },
+    "RecipientUserCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RecipientUserContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Recipient User list representation."
+    },
+    "RecipientUserContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/RecipientUsersContractProperties",
+          "description": "Recipient User entity contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Recipient User details."
+    },
+    "RecipientUsersContractProperties": {
+      "properties": {
+        "userId": {
+          "type": "string",
+          "description": "API Management UserId subscribed to notification."
+        }
+      },
+      "description": "Recipient User Contract Properties."
+    },
+    "RecipientEmailCollection": {
+      "properties": {
+        "value": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/RecipientEmailContract"
+          },
+          "description": "Page values."
+        },
+        "nextLink": {
+          "type": "string",
+          "description": "Next page link if any."
+        }
+      },
+      "description": "Paged Recipient User list representation."
+    },
+    "RecipientEmailContract": {
+      "properties": {
+        "properties": {
+          "x-ms-client-flatten": true,
+          "$ref": "#/definitions/RecipientEmailContractProperties",
+          "description": "Recipient Email contract properties."
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "./apimanagement.json#/definitions/Resource"
+        }
+      ],
+      "description": "Recipient Email details."
+    },
+    "RecipientEmailContractProperties": {
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "User Email subscribed to notification."
+        }
+      },
+      "description": "Recipient Email Contract Properties."
+    }
+  },
+  "parameters": {
+    "NotificationNameParameter": {
+      "name": "notificationName",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "enum": [
+        "RequestPublisherNotificationMessage",
+        "PurchasePublisherNotificationMessage",
+        "NewApplicationNotificationMessage",
+        "BCC",
+        "NewIssuePublisherNotificationMessage",
+        "AccountClosedPublisher",
+        "QuotaLimitApproachingPublisherNotificationMessage"
+      ],
+      "x-ms-enum": {
+        "name": "NotificationName",
+        "modelAsString": false,
+        "values": [
+          {
+            "value": "RequestPublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval."
+          },
+          {
+            "value": "PurchasePublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications about new API product subscriptions."
+          },
+          {
+            "value": "NewApplicationNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when new applications are submitted to the application gallery."
+          },
+          {
+            "value": "BCC",
+            "description": "The following recipients will receive blind carbon copies of all emails sent to developers."
+          },
+          {
+            "value": "NewIssuePublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when a new issue or comment is submitted on the developer portal."
+          },
+          {
+            "value": "AccountClosedPublisher",
+            "description": "The following email recipients and users will receive email notifications when developer closes his account."
+          },
+          {
+            "value": "QuotaLimitApproachingPublisherNotificationMessage",
+            "description": "The following email recipients and users will receive email notifications when subscription usage gets close to usage quota."
+          }
+        ]
+      },
+      "description": "Notification Name Identifier.",
+      "x-ms-parameter-location": "method"
+    },
+    "EmailParameter": {
+      "name": "email",
+      "in": "path",
+      "required": true,
+      "type": "string",
+      "description": "Email identifier.",
+      "x-ms-parameter-location": "method"
+    }
+  }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientEmail.json
new file mode 100644
index 000000000000..6fbf6926c8d3
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientEmail.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2017-03-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "email": "foobar@live.com"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+        "name": "foobar@live.com",
+        "properties": {
+            "email": "foobar@live.com"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+        "name": "foobar@live.com",
+        "properties": {
+            "email": "foobar@live.com"
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientUser.json
new file mode 100644
index 000000000000..2ad74d01b905
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementCreateRecipientUser.json
@@ -0,0 +1,32 @@
+{
+  "parameters": {
+    "serviceName": "apimService1",
+    "resourceGroupName": "rg1",
+    "api-version": "2017-03-01",
+    "subscriptionId": "subid",
+    "notificationName": "RequestPublisherNotificationMessage",
+    "uid": "576823d0a40f7e74ec07d642"
+  },
+  "responses": {
+    "201": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+        "name": "576823d0a40f7e74ec07d642",
+        "properties": {
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+        }
+      }
+    },
+    "200": {
+      "body": {
+        "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+        "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+        "name": "576823d0a40f7e74ec07d642",
+        "properties": {
+          "userId": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/users/576823d0a40f7e74ec07d642"
+        }
+      }
+    }
+  }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientEmail.json
new file mode 100644
index 000000000000..d1dfd0d2d7b2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientEmail.json
@@ -0,0 +1,13 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage",
+        "email": "contoso@live.com"
+    },
+    "responses": {
+        "204": { }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientUser.json
new file mode 100644
index 000000000000..aa45a19fe01e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementDeleteNotificationRecipientUser.json
@@ -0,0 +1,13 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage",
+        "uid": "576823d0a40f7e74ec07d642"
+    },
+    "responses": {
+        "204": { }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotification.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotification.json
new file mode 100644
index 000000000000..9652c31c78f6
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotification.json
@@ -0,0 +1,32 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage"
+    },
+    "responses": {
+        "200": {
+            "body": {
+                "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage",
+                "type": "Microsoft.ApiManagement/service/notifications",
+                "name": "RequestPublisherNotificationMessage",
+                "properties": {
+                    "title": "Subscription requests (requiring approval)",
+                    "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
+                    "recipients": {
+                        "emails": [
+                            "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/recipientEmails/contoso@live.com",
+                            "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/recipientEmails/foobar!live",
+                            "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/recipientEmails/foobar@live.com"
+                        ],
+                        "users": [
+                            "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/576823d0a40f7e74ec07d642"
+                        ]
+                    }
+                }
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientEmail.json
new file mode 100644
index 000000000000..d1dfd0d2d7b2
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientEmail.json
@@ -0,0 +1,13 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage",
+        "email": "contoso@live.com"
+    },
+    "responses": {
+        "204": { }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientUser.json
new file mode 100644
index 000000000000..aa45a19fe01e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementGetNotificationRecipientUser.json
@@ -0,0 +1,13 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage",
+        "uid": "576823d0a40f7e74ec07d642"
+    },
+    "responses": {
+        "204": { }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientEmail.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientEmail.json
new file mode 100644
index 000000000000..fcb695bc3bd5
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientEmail.json
@@ -0,0 +1,42 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage"
+    },
+    "responses": {
+        "200": {
+            "body": {
+                "value": [
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com",
+                        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+                        "name": "contoso@live.com",
+                        "properties": {
+                            "email": "contoso@live.com"
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar!live",
+                        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+                        "name": "foobar!live",
+                        "properties": {
+                            "email": "foobar!live"
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com",
+                        "type": "Microsoft.ApiManagement/service/notifications/recipientEmails",
+                        "name": "foobar@live.com",
+                        "properties": {
+                            "email": "foobar@live.com"
+                        }
+                    }
+                ],
+                "nextLink": ""
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientUser.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientUser.json
new file mode 100644
index 000000000000..505beaaa2686
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotificationRecipientUser.json
@@ -0,0 +1,26 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid",
+        "notificationName": "RequestPublisherNotificationMessage"
+    },
+    "responses": {
+        "200": {
+            "body": {
+                "value": [
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientUsers/576823d0a40f7e74ec07d642",
+                        "type": "Microsoft.ApiManagement/service/notifications/recipientUsers",
+                        "name": "576823d0a40f7e74ec07d642",
+                        "properties": {
+                            "userId": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/576823d0a40f7e74ec07d642"
+                        }
+                    }
+                ],
+                "nextLink": ""
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotifications.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotifications.json
new file mode 100644
index 000000000000..bf84c83f780e
--- /dev/null
+++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/stable/2017-03-01/examples/ApiManagementListNotifications.json
@@ -0,0 +1,126 @@
+{
+    "parameters": {
+        "serviceName": "apimService1",
+        "resourceGroupName": "rg1",
+        "api-version": "2017-03-01",
+        "subscriptionId": "subid"
+    },
+    "responses": {
+        "200": {
+            "body": {
+                "value": [
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "RequestPublisherNotificationMessage",
+                        "properties": {
+                            "title": "Subscription requests (requiring approval)",
+                            "description": "The following email recipients and users will receive email notifications about subscription requests for API products requiring approval.",
+                            "recipients": {
+                                "emails": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com",
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar!live",
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/foobar@live.com"
+                                ],
+                                "users": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/576823d0a40f7e74ec07d642"
+                                ]
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/PurchasePublisherNotificationMessage",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "PurchasePublisherNotificationMessage",
+                        "properties": {
+                            "title": "New subscriptions",
+                            "description": "The following email recipients and users will receive email notifications about new API product subscriptions.",
+                            "recipients": {
+                                "emails": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                                ],
+                                "users": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/1"
+                                ]
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/NewApplicationNotificationMessage",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "NewApplicationNotificationMessage",
+                        "properties": {
+                            "title": "Application gallery requests",
+                            "description": "The following email recipients and users will receive email notifications when new applications are submitted to the application gallery.",
+                            "recipients": {
+                                "emails": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                                ],
+                                "users": []
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/BCC",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "BCC",
+                        "properties": {
+                            "title": "BCC",
+                            "description": "The following recipients will receive blind carbon copies of all emails sent to developers.",
+                            "recipients": {
+                                "emails": [],
+                                "users": []
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/NewIssuePublisherNotificationMessage",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "NewIssuePublisherNotificationMessage",
+                        "properties": {
+                            "title": "New issue or comment",
+                            "description": "The following email recipients and users will receive email notifications when a new issue or comment is submitted on the developer portal.",
+                            "recipients": {
+                                "emails": [],
+                                "users": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/1"
+                                ]
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/AccountClosedPublisher",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "AccountClosedPublisher",
+                        "properties": {
+                            "title": "Close account message",
+                            "description": "The following email recipients and users will receive email notifications when developer closes his account",
+                            "recipients": {
+                                "emails": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/RequestPublisherNotificationMessage/recipientEmails/contoso@live.com"
+                                ],
+                                "users": []
+                            }
+                        }
+                    },
+                    {
+                        "id": "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/notifications/QuotaLimitApproachingPublisherNotificationMessage",
+                        "type": "Microsoft.ApiManagement/service/notifications",
+                        "name": "QuotaLimitApproachingPublisherNotificationMessage",
+                        "properties": {
+                            "title": "Approaching subscription quota limit",
+                            "description": "The following email recipients and users will receive email notifications when subscription usage gets close to usage quota.",
+                            "recipients": {
+                                "emails": [],
+                                "users": [
+                                    "/subscriptions/20010222-2b48-4245-a95c-090db6312d5f/resourceGroups/Admin-ResourceGroup/providers/Microsoft.ApiManagement/service/teched/users/1"
+                                ]
+                            }
+                        }
+                    }
+                ],
+                "nextLink": ""
+            }
+        }
+    }
+}
\ No newline at end of file
diff --git a/specification/apimanagement/resource-manager/readme.md b/specification/apimanagement/resource-manager/readme.md
index e1cf7eca5ba7..1386240ef763 100644
--- a/specification/apimanagement/resource-manager/readme.md
+++ b/specification/apimanagement/resource-manager/readme.md
@@ -48,6 +48,7 @@ input-file:
 - Microsoft.ApiManagement/stable/2017-03-01/apimgroups.json
 - Microsoft.ApiManagement/stable/2017-03-01/apimidentityprovider.json
 - Microsoft.ApiManagement/stable/2017-03-01/apimloggers.json
+- Microsoft.ApiManagement/stable/2017-03-01/apimnotifications.json
 - Microsoft.ApiManagement/stable/2017-03-01/apimnetworkstatus.json
 - Microsoft.ApiManagement/stable/2017-03-01/apimopenidconnectproviders.json
 - Microsoft.ApiManagement/stable/2017-03-01/apimportalsettings.json