---
title: "Create a test environment notification"
method: POST
path: "/test-environments/{id}/notifications"
tags: ["Test Environment Notifications"]
---

# Create a test environment notification

`POST /test-environments/{id}/notifications`

Use this operation to create a new notification 
for a specific Test Environment. It handles HTTP 
POST requests to the /test-environments/{id}/notifications 
endpoint, accepting a TestEnvironmentNotificationRequest 
object in the request body. Upon successful creation, 
it returns a TestEnvironmentNotificationResponse object 
and sets the Location header to the URL of the created 
notification.

### User Access Permission

You must be assigned the **Refresh Central Sandbox** permission to run this operation.

## Path parameters

- `id` string, required

## Headers

- `Zuora-Entity-Ids` string
- `Zuora-Track-Id` string
- `Accept-Encoding` string
- `Content-Encoding` string

## Request body

- TestEnvironmentNotificationRequest — Request to create a notification record for the test environment
  - `address` string — The email address to receive notifications for the Test Environment when a refresh job has been completed or cancelled
  - `name` string — The name of the recipient who will receive notifications for the Test Environment

## Response `200`

OK

- TestEnvironmentNotificationResponse — The notification response for a Test Environment
  - `address` string — The email address to receive notifications for the Test Environment when a refresh job has been completed or cancelled
  - `id` string — The unique id (UUID) of the Test Environment notification
  - `name` string — The name of the recipient who will receive notifications for the Test Environment
  - `testEnvironmentId` string — The unique id (UUID) of the Test Environment

## Other responses

- `201` — Successfully created a new Test Environment notification
- `400` — Bad request
- `500` — Internal Error

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)