---
title: "Send a signed test (a ping, or an example of one event); returns the live outcome"
method: POST
path: "/v1/me/webhooks/{id}/test"
---

# Send a signed test (a ping, or an example of one event); returns the live outcome

`POST /v1/me/webhooks/{id}/test`

## Request

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

Without a body (or `{}`) this POSTs the classic `ping`. With `{ "event": "<name>" }` it POSTs an example of that event, marked `"test": true`, so a receiver can be exercised on the exact shape it will get. `kilde` says where the example came from: `log` (the newest real change in the log, inside the endpoint's scope when one exists there), `konto` (your own job, key or plan) or `eksempel` (a fixed example). A test is not stored as a delivery.

## Path parameters

- `id` string, required

## Request body

- object
  - `event` 'key.created' | 'key.revoked' | 'subscription.updated' | 'usage.threshold' | 'adresse.oprettet' | 'adresse.aendret' | 'adresse.nedlagt' | 'ejendom.aendret' | 'cvr.oprettet' | 'cvr.aendret' | 'cvr.ophoert' | 'job.completed' | 'job.failed' | 'bygning.tilkommet' | 'bygning.aendret' | 'bygning.udgaaet'

## Response `200`

The outcome, and the exact body that was signed and POSTed

- object
  - `ok` boolean
  - `status` integer, nullable
  - `error` string, nullable
  - `event` string
  - `kilde` 'ping' | 'log' | 'konto' | 'eksempel'
  - `payload` object
    - `id` string
    - `event` string
    - `created` string, date-time
    - `test` true
    - `data` unknown

## Other responses

- `400`: Error
- `402`: Error
- `404`: 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)
