Configure Webhooks
Services Requiring Webhooks
These services require a webhook subscription:
- Invoicing through
Required NetSuite Features
These NetSuite features must be enabled to support webhooks. Go to Setup > Company > Enable Features to enable features.
- On the Web Presence tab, enable these features:
- Web site
- Host HTML files
- On the SuiteCloud tab, enable these features:
- Client SuiteScript
- Server SuiteScript
- SuiteScript Server Pages
Configure a Webhook Subscription
To configure webhooks, go to Integration > Webhook Configurations > New and enter this information:
- In the Primary Information section, enter a name and description of the webhook.
- In the Webhook Events section, select the webhook events you want.
- In the Symmetric Key Details section, the fields are populated automatically when the webhook subscription is created.
- In the Webhook Configuration section, you can manually enter the merchant credentials for webhook subscriptions or pull the merchant information automatically from an existing Payment Processing Profile or Invoicing Configuration.
When manually entering the merchant credentials, complete these fields:
- In the Merchant ID field, enter your Merchant ID.
- In the Key ID field, enter the key ID from your
RESTshared secret key. - In the Secret Key field, enter the shared secret from your REST shared secret key.
- In the Test Mode field, enable this field only when the webhooks subscription is created in the Platform test environment. Leave unchecked for production.
- In the Always Update Keys from PPP field, enable this field to automatically apply key updates from the Payment Processing Profile to the webhook subscription.
When automatically entering the merchant credentials, complete these fields:
- In the Payment Processing Profile field, choose the payment processing profile to collect credentials from.
- In the Invoicing Configuration field, choose the invoicing configuration to collect credentials from.
When the webhook record is saved, a health check runs. This process can take up to 15 minutes to complete.
Thanks for your feedback!
Last published: November 18, 2026