# Webhooks Webhook subscription management ## Get webhook subscription > Retrieve webhook subscription configuration for a tenant. Returns the registered webhook URL and retry attempt settings for receiving transaction status update notifications. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Webhooks","description":"Webhook subscription management"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"WebhookSubscriptionDetails":{"type":"object","properties":{"tenant_id":{"type":"string"},"webhook_url":{"type":"string","format":"uri"},"retry_attempts":{"type":"integer"}}}}},"paths":{"/webhooks/subscribe/{tenantId}":{"get":{"tags":["Webhooks"],"summary":"Get webhook subscription","description":"Retrieve webhook subscription configuration for a tenant. Returns the registered webhook URL and retry attempt settings for receiving transaction status update notifications.","operationId":"getWebhookSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successfully retrieved webhook subscription details","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionDetails"}}}}}}}}} ``` ## Create webhook subscription > Register a webhook URL to receive real-time transaction status update notifications. Configure the number of retry attempts for failed webhook deliveries. The system will POST transaction status updates to the registered URL whenever a transaction status changes. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Webhooks","description":"Webhook subscription management"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"SubscribeWebhookDto":{"type":"object","required":["webhook_url","retry_attempts"],"properties":{"webhook_url":{"type":"string","format":"uri","minLength":1},"retry_attempts":{"type":"integer","minimum":0}}},"WebhookSubscriptionDetails":{"type":"object","properties":{"tenant_id":{"type":"string"},"webhook_url":{"type":"string","format":"uri"},"retry_attempts":{"type":"integer"}}}}},"paths":{"/webhooks/subscribe/{tenantId}":{"post":{"tags":["Webhooks"],"summary":"Create webhook subscription","description":"Register a webhook URL to receive real-time transaction status update notifications. Configure the number of retry attempts for failed webhook deliveries. The system will POST transaction status updates to the registered URL whenever a transaction status changes.","operationId":"createWebhookSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeWebhookDto"}}}},"responses":{"201":{"description":"Webhook subscription created successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionDetails"}}}},"400":{"description":"Bad request - Invalid webhook URL or configuration"},"401":{"description":"Unauthorized - Invalid or missing API key"},"409":{"description":"Conflict - Webhook subscription already exists"},"500":{"description":"Internal server error"}}}}}} ``` ## Update webhook subscription > Update webhook subscription configuration for a tenant. Modify the registered webhook URL and/or the number of retry attempts for failed deliveries. Returns 404 if no subscription exists. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Webhooks","description":"Webhook subscription management"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}},"schemas":{"SubscribeWebhookDto":{"type":"object","required":["webhook_url","retry_attempts"],"properties":{"webhook_url":{"type":"string","format":"uri","minLength":1},"retry_attempts":{"type":"integer","minimum":0}}},"WebhookSubscriptionDetails":{"type":"object","properties":{"tenant_id":{"type":"string"},"webhook_url":{"type":"string","format":"uri"},"retry_attempts":{"type":"integer"}}}}},"paths":{"/webhooks/subscribe/{tenantId}":{"put":{"tags":["Webhooks"],"summary":"Update webhook subscription","description":"Update webhook subscription configuration for a tenant. Modify the registered webhook URL and/or the number of retry attempts for failed deliveries. Returns 404 if no subscription exists.","operationId":"updateWebhookSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeWebhookDto"}}}},"responses":{"200":{"description":"Webhook subscription updated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookSubscriptionDetails"}}}},"400":{"description":"Bad request - Invalid webhook URL or configuration"},"401":{"description":"Unauthorized - Invalid or missing API key"},"404":{"description":"Not found - Webhook subscription does not exist"},"500":{"description":"Internal server error"}}}}}} ``` ## Delete webhook subscription > Remove webhook subscription for a tenant. After deletion, the tenant will no longer receive transaction status update notifications. Returns 404 if no subscription exists. ```json {"openapi":"3.1.0","info":{"title":"Minit Money Enterprise API","version":"1.12.8"},"tags":[{"name":"Webhooks","description":"Webhook subscription management"}],"servers":[{"url":"/api/v1","description":"API v1"},{"url":"/","description":"API v0 (Legacy)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"API key for tenant authentication"}}},"paths":{"/webhooks/subscribe/{tenantId}":{"delete":{"tags":["Webhooks"],"summary":"Delete webhook subscription","description":"Remove webhook subscription for a tenant. After deletion, the tenant will no longer receive transaction status update notifications. Returns 404 if no subscription exists.","operationId":"deleteWebhookSubscription","parameters":[{"name":"tenantId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Webhook subscription deleted successfully"},"401":{"description":"Unauthorized - Invalid or missing API key"},"404":{"description":"Not found - Webhook subscription does not exist"},"500":{"description":"Internal server error"}}}}}} ``` {% openapi-webhook spec="mm-raas" name="transactionStatusUpdate" method="post" %} [mm-raas](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/08ad24713eeaf7600b046092d7b8012bcc93fefbb1492a22a9cf1c3b82890452.json?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260523%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260523T160911Z\&X-Amz-Expires=172800\&X-Amz-Signature=64b2393daf0810ecfc35add2602c58ad37319aac731348abccd2c04d650b4f2e\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject) {% endopenapi-webhook %} --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.minitmoney.enterprises/raas-api/webhooks.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.