Create a new webhook

POST

/v1/webhooks

Creates a new webhook configuration for the authenticated client.
The clientId and userEmail are resolved from the JWT token and do not need
to be included in the request body.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

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

Body Params application/jsonRequired

Example

{
    "type": "PAYMENT",
    "url": "https://example.com/webhook/payment",
    "descriptions": "Webhook for payment notifications",
    "criteriaMethods": [
        {
            "code": "EWALLET_TNG",
            "name": "e-Wallet TNG",
            "groupCode": "EWALLET",
            "groupName": "e-Wallet"
        },
        {
            "code": "EWALLET_GRABPAY",
            "name": "e-Wallet GRABPAY",
            "groupCode": "EWALLET",
            "groupName": "e-Wallet"
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/v1/webhooks' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "type": "PAYMENT",
    "url": "https://example.com/webhook/payment",
    "descriptions": "Webhook for payment notifications",
    "criteriaMethods": [
        {
            "code": "EWALLET_TNG",
            "name": "e-Wallet TNG",
            "groupCode": "EWALLET",
            "groupName": "e-Wallet"
        },
        {
            "code": "EWALLET_GRABPAY",
            "name": "e-Wallet GRABPAY",
            "groupCode": "EWALLET",
            "groupName": "e-Wallet"
        }
    ]
}'

Responses

🟢200

application/json

Webhook created successfully

Body

Example

{
    "status": "200",
    "message": "success",
    "data": {
        "id": 1,
        "webhookId": "WBH-20240101-ABC123",
        "type": "PAYMENT",
        "url": "https://example.com/webhook/payment",
        "descriptions": "Webhook for payment notifications",
        "createdDate": "2024-01-01T10:00:00+07:00",
        "updatedDate": "2024-01-01T10:00:00+07:00",
        "criteriaMethods": [
            {
                "code": "EWALLET_TNG",
                "name": "e-Wallet TNG",
                "groupCode": "EWALLET",
                "groupName": "e-Wallet"
            },
            {
                "code": "EWALLET_GRABPAY",
                "name": "e-Wallet GRABPAY",
                "groupCode": "EWALLET",
                "groupName": "e-Wallet"
            }
        ]
    }
}

🟠400

🟠401

🔴500

Modified at 2026-02-19 02:47:34

Override Notification URL

Get all webhooks