Skip to main content
PATCH
/
notifications
/
webhooks
/
{webhookProfileId}
Update an existing webhook profile
curl --request PATCH \
  --url https://api-sb.meld.io/notifications/webhooks/{webhookProfileId} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventTypes": [],
  "eventVersion": "<string>",
  "name": "<string>",
  "url": "<string>"
}
'
{
  "accountId": "<string>",
  "eventTypes": [
    "<string>"
  ],
  "eventVersion": "<string>",
  "id": "<string>",
  "key": "<string>",
  "name": "<string>",
  "secret": "<string>",
  "url": "<string>"
}

Authorizations

Authorization
string
header
default:BASIC <Meld API Key>
required

Path Parameters

webhookProfileId
string
required

Unique identifier for the webhook profile

Body

application/json
eventTypes
enum<string>[]

Event types that will be sent to the URL. If empty, then all events will be sent to the URL.

Reference Webhook events

Available options:
TRANSACTION_CRYPTO_PENDING,
TRANSACTION_CRYPTO_FAILED,
TRANSACTION_CRYPTO_TRANSFERRING,
TRANSACTION_CRYPTO_COMPLETE,
TRANSACTION_FIAT_CREATED,
TRANSACTION_FIAT_UPDATED,
BANK_LINKING_CONNECTION_COMPLETED,
BANK_LINKING_CONNECTION_DELETED,
BANK_LINKING_CONNECTION_STATUS_CHANGE,
BANK_LINKING_ACCOUNTS_ADDED,
BANK_LINKING_ACCOUNTS_UPDATING,
BANK_LINKING_ACCOUNTS_UPDATED,
BANK_LINKING_ACCOUNTS_REMOVED,
BANK_LINKING_TRANSACTIONS_AGGREGATED,
BANK_LINKING_HISTORICAL_TRANSACTIONS_AGGREGATED,
BANK_LINKING_NEW_ACCOUNTS_AVAILABLE,
CUSTOMER_KYC_STATUS_CHANGE,
TEST,
WEBHOOK_TEST
eventVersion
string

Version of webhooks sent to the URL.

Reference Webhook version

name
string

Display name

status
enum<string>

Status

Available options:
ACTIVE,
DISABLED
url
string

URL where webhooks will be sent

Response

Webhook profile has been updated

accountId
string

Account Id

eventTypes
string[]

Event types that will be sent to the URL. If empty, then all events will be sent to the URL.

Reference Webhook events

eventVersion
string

Version of webhooks sent to the URL.

Reference Webhook version

id
string

Unique identifier

key
string

Unique key corresponding to a webhook profile's position in a paginated list of results. Only present if this webhook profile is in a paginated response.

Reference Pagination

name
string

Display name

secret
string

Secret used to validate authenticity of a webhook.

Reference Webhook authentication

status
enum<string>

Current status

Available options:
ACTIVE,
DISABLED
url
string

URL where webhooks will be sent