Configure Webhook

POST

/api/v1/webhook/config

Set a single webhook listener URL and secret. Each call overwrites the previous configuration.

Request

Authorization

API Key

Add parameter in header

x-signature

Example:

x-signature: ********************

Header Params

Body Params application/json

Example

{
    "url": "http://example.com",
    "secret": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/webhook/config' \
--header 'x-app-id;' \
--header 'x-timestamp: 0' \
--header 'x-nonce;' \
--header 'x-request-id;' \
--header 'x-lang;' \
--header 'x-signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "http://example.com",
    "secret": "string"
}'

Responses

🟢200OK

application/json

Webhook configured successfully

Bodyapplication/json

Example

{
    "success": true,
    "requestId": "string",
    "timestamp": "2019-08-24T14:15:22.123Z",
    "data": {
        "url": "http://example.com",
        "secretLast4": "string",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

Modified at 2025-09-26 03:46:34

Query Exchange Rates V2

Webhook Event Endpoint