Skip to main content
POST
/
api
/
service
/
webhook-subscription
/
update
JavaScript
import Ivy from '@getivy/node-sdk';

const client = new Ivy({
  apiKey: process.env['IVY_API_KEY'], // This is the default and can be omitted
});

const subscription = await client.webhook.subscription.update({ id: {} });

console.log(subscription.id);
{
  "id": "<unknown>",
  "merchant": "<unknown>",
  "merchantApp": "<unknown>",
  "url": "<string>",
  "events": [],
  "createdAt": "<unknown>",
  "updatedAt": "<unknown>"
}

Authorizations

​
X-Ivy-Api-Key
string
header
required

API key for authentication

Headers

​
Idempotency-Key
string

Idempotency key for safe retries. Reusing a key with an identical request body returns the cached response. Reusing a key with a different body returns 409.

Body

application/json
​
id
any
required

The unique identifier of the webhook subscription to update

​
url
string

The new endpoint where webhook events are sent

​
events
enum<string>[]

The new events to subscribe the url to

Available options:
test,
merchant_updated,
merchant_app_updated,
order_created,
order_updated,
refund_succeeded,
refund_failed,
refund.initiated,
refund.succeeded,
refund.failed,
payout_report_requested,
data_session_completed,
checkout_session_created,
checkout_session_updated,
checkout_session_expired,
checkout_session_completed,
payout_created,
payout_updated,
user_payout.initiated,
user_payout.failed,
user_payout.paid,
payout.initiated,
payout.failed,
payout.paid,
deposit.received,
return.initiated,
return.succeeded,
return.failed,
return.returned,
fx.initiated,
fx.succeeded,
fx.failed

Response

200 - application/json

Returns the updated webhook subscription.

​
id
any
required
​
merchant
any
required
​
merchantApp
any
required
​
url
string
required
​
events
enum<string>[]
required
Available options:
test,
merchant_updated,
merchant_app_updated,
order_created,
order_updated,
refund_succeeded,
refund_failed,
refund.initiated,
refund.succeeded,
refund.failed,
payout_report_requested,
data_session_completed,
checkout_session_created,
checkout_session_updated,
checkout_session_expired,
checkout_session_completed,
payout_created,
payout_updated,
user_payout.initiated,
user_payout.failed,
user_payout.paid,
payout.initiated,
payout.failed,
payout.paid,
deposit.received,
return.initiated,
return.succeeded,
return.failed,
return.returned,
fx.initiated,
fx.succeeded,
fx.failed
​
createdAt
any
required
​
updatedAt
any
required