---
title: "Register a webhook endpoint (the signing secret is returned ONCE)"
method: POST
path: "/v1/me/webhooks"
---

# Register a webhook endpoint (the signing secret is returned ONCE)

`POST /v1/me/webhooks`

## Request

- Base URL: `https://api.grundfast.dk`
- URL: `https://api.grundfast.dk/v1/me/webhooks`
- Auth: API key in cookie `gf_session`

## Request body

- object
  - `url` string, uri, required
  - `events` string[], required
  - `description` string
  - `adresseFilter` object: Required when `events` includes an adresse.* or bygning.* event: the area scope (any listed kommune, postnummer, adgangsadresse id or BFE number) of the address and building changes delivered to this endpoint. A BFE matches a building change on the property and an address change on an adgangsadresse the address index places on it.
    - `kommunekoder` string[]
    - `postnumre` string[]
    - `adgangsadresseIds` string[]
    - `bfeNumre` integer[]
  - `cvrFilter` object: Required when `events` includes a cvr.* event: the scope of the company changes delivered to this endpoint — any listed CVR-nummer, or a company whose registered address is (or was, before a move) in a listed kommune.
    - `cvrNumre` integer[]
    - `kommunekoder` string[]

## Response `201`

Created

## Other responses

- `400`: Error
- `401`: Error

---

[API](https://skmtc.dev/grundfast/apis/grundfast-api.md) · [All operations](https://skmtc.dev/grundfast/apis/grundfast-api/llms.txt) · [OpenAPI document](https://skmtc.dev/grundfast/apis/grundfast-api/revisions/ccef6e299bb5?raw)