WebhookApplicationInterface

Interface added to an Application class to mark it as webhook-aware. Implement it alongside ApplicationAbstract (or any of its descendants).

PHP currently uses this interface as the canonical webhook integration path. The Node.js SDK has additionally introduced an AWebhookApplication abstract base class plus a WebhookSubscription::create factory; the equivalent PHP base class is planned but not yet shipped. Until then, implement this interface directly. The node and topology arguments of the WebhookSubscription constructor are accepted for backwards compatibility but ignored — those values come from the UI through WebhookConfig.

use Hanaboso\PipesPhpSdk\Application\Manager\Webhook\WebhookApplicationInterface;

Methods you implement #

MethodReturnsPurpose
getWebhookSubscriptions()WebhookSubscription[]Available subscriptions: event name, parameters, default topology + node.
getWebhookSubscribeRequestDto(ApplicationInstall $install, WebhookSubscription $subscription, string $url)RequestDtoHTTP request that registers a webhook with the third-party API.
getWebhookUnsubscribeRequestDto(ApplicationInstall $install, Webhook $webhook)RequestDtoHTTP request that removes a webhook by id.
processWebhookSubscribeResponse(ResponseDto $response, ApplicationInstall $install)stringReads the third-party response and returns the external webhook id.
processWebhookUnsubscribeResponse(ResponseDto $response)boolConfirms the unsubscribe request succeeded.

See also #

© 2025 Orchesty Solutions. All rights reserved.