---
title: "Create Notification Endpoint"
method: POST
path: "/notifications/endpoints"
tags: ["Notifications"]
---

# Create Notification Endpoint

`POST /notifications/endpoints`

## Request body

- NotificationsApiCreateNotificationEndpointRequestBody
  - `webhookSecret` string, nullable
  - `id` string
  - `organizationId` string, required
  - `name` string, required
  - `type` 'Slack' | 'Teams' | 'Email' | 'Webhook', required
  - `value` string, required — URL for Slack, Teams or Webhooks endpoint. Coma separated list of email addresses for email endpoint, you can use `$ENVIRONMENT_CREATOR$`, and `$DEPLOYER$` to resolve emails dynamically.

## Response `200`

- NotificationsApiCreateNotificationEndpointResponse
  - `id` string
  - `createdBy` string
  - `createdByUser` User
    - `email` string
    - `user_id` string
    - `created_at` string
    - `updated_at` string
    - `app_metadata` AppMetadata
      - `organizations` UserOrganization[]
        - `id` string, required
        - `role` string
        - `name` string
      - `isApiKey` boolean
      - `isAutogeneratedTerraformDeployer` boolean
      - `apiKeyType` 'oidc'
      - `createdBy` string
      - `organizationId` string
      - `isSystemUser` boolean
      - `readOnly` boolean
    - `picture` string
    - `name` string
    - `last_login` string
    - `given_name` string
    - `family_name` string
    - `blocked` boolean
  - `organizationId` string
  - `name` string
  - `type` 'Slack' | 'Teams' | 'Email' | 'Webhook'
  - `value` string — URL for Slack, Teams or Webhooks endpoint. Coma separated list of email addresses for email endpoint, you can use `$ENVIRONMENT_CREATOR$`, and `$DEPLOYER$` to resolve emails dynamically.

---

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