---
title: "register a new event-triggered webhook"
method: POST
path: "/simulator/webhooks"
tags: ["simulator"]
---

# register a new event-triggered webhook

`POST /simulator/webhooks`

## Request body

- object
  - `webhooks` string[], required
  - `notificationUrl` string, uri, required

## Response `201`

Webhook registered

- WebhooksSubscription
  - `subscriptionId` string, uuid, required

## Other responses

- `401` — Access token is missing or invalid

## Changes

> 4 revisions in range; 1 could not be searched.

- **2021-07-17** `4c1c8b98a933` — 2 info
  - added the new `automation_level_changed` enum value to the request property `webhooks/items/`
  - added the new `driver_changed` enum value to the request property `webhooks/items/`
- **2021-05-23** `721e64938b54` — 1 info
  - endpoint added
- **2020-07-03** `f4f4c18b287e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/knowgoio/apis/knowgo-vehicle-simulator-api/changes/simulator/webhooks/post.md)

---

[API](https://skmtc.dev/knowgoio/apis/knowgo-vehicle-simulator-api.md) · [All operations](https://skmtc.dev/knowgoio/apis/knowgo-vehicle-simulator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/knowgoio/knowgo-vehicle-simulator-api/revisions/c420a5f456ea/schema)