Skip to navigation
API ReferenceWebhooks

Update a webhook subscription

Available by request

Webhooks are only available for certain clients. Contact your Rush Order representative to have them enabled. Creating or changing subscriptions with an API key must also be enabled for your account; otherwise this returns 403.

Changes only the fields you send; anything omitted or null is left as it is. To pause a subscription, send {"Active": false}.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <base64(username:password)>.

Path parameters

idintegerRequired
The subscription ID.

Headers

RushOrderMomCodestringRequired
All requests require the header to contain RushOrderMomCode, a 3 character string that represents the client internally in Rush Order. This should be given to you by Rush Order.

Request

This endpoint expects an object.
NamestringOptional
Must be unique among your subscriptions.
TargetUrlstringOptional

Where deliveries are sent. Must use https on port 443, have a public host name that resolves only to public IP addresses, contain no user name or password, and be at most 2048 characters.

DescriptionstringOptional
Send an empty string to clear it.
ActivebooleanOptional
Set to false to pause the subscription.
EventTypeslist of stringsOptional

Replaces the current event types. Can’t be empty. See GET /webhooks/event-types for the list.

Response

Success
IdintegerOptional
NamestringOptional
TargetUrlstringOptional
Descriptionstring or nullOptional
ActivebooleanOptional
Inactive subscriptions receive no deliveries.
CreatedAtdatetimeOptional
ModifiedAtdatetime or nullOptional
EventTypeslist of stringsOptional
PreviousSecretExpiresAtdatetime or nullOptional
Set after a secret rotation while the previous secret is still signing deliveries.

Errors

400
Bad Request Error
403
Forbidden Error
404
Not Found Error