preg_match).',
+ 'search_in_title_label' => '🪧 title * ',
+ 'search_in_feed_label' => '💼 feed ',
+ 'search_in_authors_label' => '👥 authors ',
+ 'search_in_content_label' => '📄 content ',
+ 'mark_as_read' => 'Mark as read',
+ 'mark_as_read_description' => 'Mark the article as read after sending the webhook.',
+ 'mark_as_read_label' => 'Mark as read',
+ 'http_body' => 'HTTP Body',
+ 'http_body_description' => 'Must be valid JSON or form data (x-www-form-urlencoded)',
+ 'http_body_placeholder_summary' => 'You can use special placeholders that will be replaced by the actual values:',
+ 'http_body_placeholder_title' => 'Placeholder',
+ 'http_body_placeholder_description' => 'Description',
+ 'http_body_placeholder_title_description' => 'Article title',
+ 'http_body_placeholder_url_description' => 'HTML-encoded link of the article',
+ 'http_body_placeholder_content_description' => 'Content of the article (HTML format)',
+ 'http_body_placeholder_authors_description' => 'Authors of the article',
+ 'http_body_placeholder_feed_description' => 'Feed of the article',
+ 'http_body_placeholder_tags_description' => 'Article tags (string, separated by " #")',
+ 'http_body_placeholder_date_description' => 'Date of the article (string)',
+ 'http_body_placeholder_date_timestamp_description' => 'Date of the article as timestamp (number)',
+ 'http_body_placeholder_thumbnail_url_description' => 'Thumbnail (image) URL',
+ 'webhook_headers' => 'HTTP HeadersContent-type: application/x-www-form-urlencoded the keys and values are encoded in key-value tuples separated by "&", with a "=" between the key and the value. Non-alphanumeric characters in both keys and values are URL encoded'
+ ),
+);
diff --git a/xExtension-Webhook/metadata.json b/xExtension-Webhook/metadata.json
new file mode 100644
index 00000000..6cba9dde
--- /dev/null
+++ b/xExtension-Webhook/metadata.json
@@ -0,0 +1,8 @@
+{
+ "name": "Webhook",
+ "author": "Lukas Melega, Ryahn",
+ "description": "Send custom webhook when new article appears (and matches custom criteria)",
+ "version": "0.1.1",
+ "entrypoint": "Webhook",
+ "type": "system"
+}
diff --git a/xExtension-Webhook/request.php b/xExtension-Webhook/request.php
new file mode 100644
index 00000000..5a4143d1
--- /dev/null
+++ b/xExtension-Webhook/request.php
@@ -0,0 +1,309 @@
+getMessage()} | URL: {$url} | Body: {$body}");
+ throw $err;
+ } finally {
+ curl_close($ch);
+ }
+}
+
+/**
+ * Configure cURL HTTP method settings
+ *
+ * Sets the appropriate cURL options based on the HTTP method.
+ *
+ * @param CurlHandle $ch The cURL handle
+ * @param string $method HTTP method in uppercase
+ *
+ * @return void
+ */
+function configureHttpMethod(CurlHandle $ch, string $method): void {
+ curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+
+ switch ($method) {
+ case 'POST':
+ curl_setopt($ch, CURLOPT_POST, true);
+ break;
+ case 'PUT':
+ curl_setopt($ch, CURLOPT_PUT, true);
+ break;
+ case 'GET':
+ curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');
+ break;
+ case 'DELETE':
+ case 'PATCH':
+ case 'OPTIONS':
+ case 'HEAD':
+ curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
+ break;
+ }
+}
+
+/**
+ * Process HTTP body based on content type
+ *
+ * Converts the request body to the appropriate format based on the body type.
+ * Supports JSON and form-encoded data.
+ *
+ * @param string $body Raw body content as JSON string
+ * @param string $bodyType Content type ('json' or 'form')
+ * @param string $method HTTP method
+ * @param bool $logEnabled Whether logging is enabled
+ *
+ * @throws JsonException When JSON processing fails
+ * @throws InvalidArgumentException When unsupported body type is provided
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return string|null Processed body content or null if no body needed
+ */
+function processHttpBody(string $body, string $bodyType, string $method, bool $logEnabled): ?string {
+ if (empty($body) || $method === 'GET') {
+ return null;
+ }
+
+ try {
+ $bodyObject = json_decode($body, true, 256, JSON_THROW_ON_ERROR);
+
+ return match ($bodyType) {
+ 'json' => json_encode($bodyObject, JSON_THROW_ON_ERROR),
+ 'form' => http_build_query($bodyObject ?? []),
+ default => throw new InvalidArgumentException("Unsupported body type: {$bodyType}")
+ };
+ } catch (JsonException $err) {
+ logError($logEnabled, "JSON processing error: {$err->getMessage()} | Body: {$body}");
+ throw $err;
+ }
+}
+
+/**
+ * Configure HTTP headers for the request
+ *
+ * Sets appropriate Content-Type headers if none are provided,
+ * based on the body type.
+ *
+ * @param string[] $headers Array of custom headers
+ * @param string $bodyType Content type ('json' or 'form')
+ *
+ * @return string[] Final array of headers to use
+ */
+function configureHeaders(array $headers, string $bodyType): array {
+ if (empty($headers)) {
+ return match ($bodyType) {
+ 'form' => ['Content-Type: application/x-www-form-urlencoded'],
+ 'json' => ['Content-Type: application/json'],
+ default => []
+ };
+ }
+
+ return $headers;
+}
+
+/**
+ * Log the outgoing HTTP request details
+ *
+ * Logs comprehensive information about the request being sent,
+ * including URL, method, body, and headers.
+ *
+ * @param bool $logEnabled Whether logging is enabled
+ * @param string $additionalLog Additional context information
+ * @param string $method HTTP method
+ * @param string $url Target URL
+ * @param string $bodyType Content type
+ * @param string|null $body Processed request body
+ * @param string[] $headers Array of HTTP headers
+ *
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function logRequest(
+ bool $logEnabled,
+ string $additionalLog,
+ string $method,
+ string $url,
+ string $bodyType,
+ ?string $body,
+ array $headers
+): void {
+ if (!$logEnabled) {
+ return;
+ }
+
+ $cleanUrl = urldecode($url);
+ $cleanBody = $body ? str_replace('\/', '/', $body) : '';
+ $headersJson = json_encode($headers);
+
+ $logMessage = trim("{$additionalLog} ♦♦ sendReq ⏩ {$method}: {$cleanUrl} ♦♦ {$bodyType} ♦♦ {$cleanBody} ♦♦ {$headersJson}");
+
+ logWarning($logEnabled, $logMessage);
+}
+
+/**
+ * Execute cURL request and handle response
+ *
+ * Executes the configured cURL request and handles both success
+ * and error responses with appropriate logging.
+ *
+ * @param CurlHandle $ch The configured cURL handle
+ * @param bool $logEnabled Whether logging is enabled
+ *
+ * @throws RuntimeException When cURL execution fails
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function executeRequest(CurlHandle $ch, bool $logEnabled): void {
+ $response = curl_exec($ch);
+
+ if (curl_errno($ch)) {
+ $error = curl_error($ch);
+ logError($logEnabled, "cURL error: {$error}");
+ throw new RuntimeException("cURL error: {$error}");
+ }
+
+ $info = curl_getinfo($ch);
+ $httpCode = $info['http_code'] ?? 'unknown';
+
+ logWarning($logEnabled, "Response ✅ ({$httpCode}) {$response}");
+}
+
+/**
+ * Log warning message using FreshRSS logging system
+ *
+ * Safely logs warning messages through the FreshRSS Minz_Log system
+ * with proper class existence checking.
+ *
+ * @param bool $logEnabled Whether logging is enabled
+ * @param mixed $data Data to log (will be converted to string)
+ *
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function logWarning(bool $logEnabled, $data): void {
+ if ($logEnabled && class_exists('Minz_Log')) {
+ Minz_Log::warning("[WEBHOOK] " . $data);
+ }
+}
+
+/**
+ * Log error message using FreshRSS logging system
+ *
+ * Safely logs error messages through the FreshRSS Minz_Log system
+ * with proper class existence checking.
+ *
+ * @param bool $logEnabled Whether logging is enabled
+ * @param mixed $data Data to log (will be converted to string)
+ *
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function logError(bool $logEnabled, $data): void {
+ if ($logEnabled && class_exists('Minz_Log')) {
+ Minz_Log::error("[WEBHOOK]❌ " . $data);
+ }
+}
+
+/**
+ * Backward compatibility alias for logWarning function
+ *
+ * @deprecated Use logWarning() instead
+ * @param bool $logEnabled Whether logging is enabled
+ * @param mixed $data Data to log
+ *
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function LOG_WARN(bool $logEnabled, $data): void {
+ logWarning($logEnabled, $data);
+}
+
+/**
+ * Backward compatibility alias for logError function
+ *
+ * @deprecated Use logError() instead
+ * @param bool $logEnabled Whether logging is enabled
+ * @param mixed $data Data to log
+ *
+ * @throws Minz_PermissionDeniedException
+ *
+ * @return void
+ */
+function LOG_ERR(bool $logEnabled, $data): void {
+ logError($logEnabled, $data);
+}