# Retrieve a webhook

Endpoint: GET /webhooks/{webhookID}
Version: 1.0.457.36910
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2 scopes: FullAccess, WebhookAdmin, WebhookReader

## Path parameters:

  - `webhookID` (string, required)
    ID of the webhook.

## Response 200 fields (application/json):

  - `ID` (string)

  - `Name` (string)

  - `Description` (string)

  - `Url` (string)
    URL the webhook will POST data to, likely a route within your middleware. Required unless there is a valid DeliveryConfig.

  - `HashKey` (string)
    Security feature that allows your middleware to verify the digital signature in the request header to ensure you only accept trusted data.

  - `ElevatedRoles` (array)
    If you need additional data not provided by the webhook payload, you can request any elevated roles needed to make additional calls.

  - `ConfigData` (object)

  - `BeforeProcessRequest` (boolean)
    If true, the webhook is processed prior to the call being made and OrderCloud waits for a response before proceeding.

  - `ApiClientIDs` (array)
    List of API client IDs the webhook will be triggered for.

  - `WebhookRoutes` (array)
    List of routes the webhook will be triggered for.

  - `WebhookRoutes.Route` (string)

  - `WebhookRoutes.Verb` (string)

  - `DeliveryConfigID` (string)

  - `CustomAuthHeaderName` (string)
    The header name that can be passed to your middleware.

  - `CustomAuthHeaderValue` (string)
    The header value that can be passed to your middleware.

## Response 4XX:

  - `4XX` (unknown)
    Expected errors range from 400-409. Anything in the 5XX range indicates a server issue and should be reported to support.

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: 404

  - `ErrorCode` (string)
    Example: NotFoundError

  - `Message` (string)
    Example: Object not found

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}