Update a webhook handler Reference Published Oct 13, 2026 Update a webhook handler in Dynatrace with the AutomationEngine API by connection ID and configure its validation and secret settings.
PUT SaaS https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/webhook-handlers/{connectionId}
Overview You update the webhook handler identified by the connectionId path parameter. The request body can include active, validationMethod, eventSignatureHeader, slackSigningSecret, staticSecret, hmacSignaturePrefix, hmacSignatureEncoding, and hmacSecret, and it returns a 200 response.
Authentication To execute this request, you need a platform token or OAuth access token with automation:webhookhandlers:write scope. To learn how to obtain and use it, see Tokens and authentication .
Parameters connectionId string The ID of the connection this webhook handler belongs to
path Required body Webhook - body Required
Request body objects The WebhookHandlerWrite object active boolean - Required validationMethod Validation -The element can hold these values Required eventSignatureHeader string - Required slackSigningSecret string - Optional staticSecret string - Optional hmacSignaturePrefix string - Optional hmacSignatureEncoding Hmac -The element can hold these values Optional hmacSecret string - Optional
The ValidationMethod object
The HmacSignatureEncoding object Request body JSON model This is a model of the request body, showing the possible elements. It has to be adjusted for usage in an actual request.
{
"active" : true ,
"validationMethod" : "slack" ,
"eventSignatureHeader" : "string" ,
"slackSigningSecret" : "string" ,
"staticSecret" : "string" ,
"hmacSignaturePrefix" : "string" ,
"hmacSignatureEncoding" : "hex" ,
"hmacSecret" : "string"
}
Response Response body objects The WebhookHandler object connectionId string The connection ID that this webhook corresponds to.
webhookUrl string - active boolean - validationMethod Validation -The element can hold these values eventSignatureHeader string - slackSigningSecret string - staticSecret string - hmacSignaturePrefix string - hmacSignatureEncoding Hmac -The element can hold these values hmacSecret string -
The ValidationMethod object
The HmacSignatureEncoding object The ErrorDetails object errorCode string - errorRef string -
Response body JSON models {
"connectionId" : "string" ,
"webhookUrl" : "string" ,
"active" : true ,
"validationMethod" : "slack" ,
"eventSignatureHeader" : "string" ,
"slackSigningSecret" : "string" ,
"staticSecret" : "string" ,
"hmacSignaturePrefix" : "string" ,
"hmacSignatureEncoding" : "hex" ,
"hmacSecret" : "string"
}
{
"error" : {
"message" : "string" ,
"code" : 1 ,
"details" : {
"errorCode" : "string" ,
"errorRef" : "string"
}
}
}