---
title: "POST /events/transports/"
method: POST
path: "/events/transports/"
tags: ["events"]
---

# POST /events/transports/

`POST /events/transports/`

NotificationTransport Viewset

## Request body

- NotificationTransportRequest — NotificationTransport Serializer
  - `name` string, required
  - `mode` 'local' | 'webhook' | 'webhook_slack' | 'email'
  - `webhook_url` string, uri
  - `webhook_ca` string, uuid, nullable — When set, the selected certificate is used to validate the certificate of the webhook server.
  - `webhook_mapping_body` string, uuid, nullable — Customize the body of the request. Mapping should return data that is JSON-serializable.
  - `webhook_mapping_headers` string, uuid, nullable — Configure additional headers to be sent. Mapping should return a dictionary of key-value pairs
  - `email_subject_prefix` string
  - `email_template` string
  - `send_once` boolean — Only send notification once, for example when sending a webhook into a chat channel.

## Response `201`

- NotificationTransport — NotificationTransport Serializer
  - `pk` string, uuid, required
  - `name` string, required
  - `mode` 'local' | 'webhook' | 'webhook_slack' | 'email'
  - `mode_verbose` string, required — Return selected mode with a UI Label
  - `webhook_url` string, uri
  - `webhook_ca` string, uuid, nullable — When set, the selected certificate is used to validate the certificate of the webhook server.
  - `webhook_mapping_body` string, uuid, nullable — Customize the body of the request. Mapping should return data that is JSON-serializable.
  - `webhook_mapping_headers` string, uuid, nullable — Configure additional headers to be sent. Mapping should return a dictionary of key-value pairs
  - `email_subject_prefix` string
  - `email_template` string
  - `send_once` boolean — Only send notification once, for example when sending a webhook into a chat channel.

## Other responses

- `400`
- `403`

---

[API](https://skmtc.dev/goauthentik/apis/authentik.md) · [All operations](https://skmtc.dev/goauthentik/apis/authentik/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goauthentik/authentik/revisions/4e42e86021d7/schema)