Registers (or replaces) the URL webhooks are delivered to for the integrator

POST

/integration/webhooks/subscription

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/json

Example

{
    "url": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://my.test-1.account.finlego.com/api/merchant/integration/webhooks/subscription' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "string"
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "isFailed": true,
    "isSuccess": true,
    "reasons": [
        {
            "message": "string",
            "metadata": {
                "property1": null,
                "property2": null
            }
        }
    ],
    "errors": [
        {
            "message": "string",
            "metadata": {
                "property1": null,
                "property2": null
            },
            "reasons": [
                {}
            ]
        }
    ],
    "successes": [
        {
            "message": "string",
            "metadata": {
                "property1": null,
                "property2": null
            }
        }
    ]
}

🟠400

🟠401

🟠403

🔴500

Modified at 2026-08-19 08:22:13

Returns a transfer by its identifier

Returns the currently registered webhook URL for the integrator