Update WebHook - Nexudus Platform

PUT

api

sys

webhooks

Update WebHook

curl --request PUT \
  --url https://spaces.nexudus.com/api/sys/webhooks \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "BusinessId": 123,
  "Name": "<string>",
  "Action": 123,
  "URL": "<string>"
}
'

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

Updates an existing WebHook record. You must include the Id of the record to update along with all required fields.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the WebHook-Edit role.

Enums

eWebhookAction — Action values

Value	Name
1	None
2	CoworkerUpdate
3	CoworkerCreate
4	BlogPostCreate
5	BlogPostUpdate
6	BookingCreate
7	BookingUpdate
8	BookingDelete
9	SendWelcomeEmail
10	CoworkerContractActivate
11	CoworkerContractCancel
12	CoworkerContractRenew
13	CoworkerContractUpgradeDowngrade
14	CoworkerContractActivateFirst
15	CoworkerInvoiceCreateFirst
16	CoworkerInvoiceCreate
17	CoworkerInvoiceDelete
18	CoworkerInvoiceUpdate
19	CoworkerInvoiceRefund
20	CoworkerInvoiceCreditNote
21	CoworkerInvoicePaid
22	CoworkerInvoiceFailedPayment
23	CoworkerInvoiceReceivedPayment
24	CoworkerInvoiceAwaitingPayment
25	CalendarEventCreate
26	CalendarEventUpdate
27	CalendarEventAttendeeDelete
28	CalendarEventAttendeeCreate
29	CalendarEventAttendeeUpdate
30	GlobalChatMessageCreate
31	NewsLetterSubscriberCreate
32	NewsLetterSubscriberSubscribed
33	NewsLetterSubscriberUnSubscribed
34	NewsLetterSubscriberRemovedFromGroup
35	CoworkerCheckout
36	CoworkerCheckin
37	CoworkerCheckinFailed
38	VisitorNotification
39	CommunityBoardNewThread
40	CommunityBoardNewReply
41	VisitorCheckedin
42	VisitorRegistered
43	BlogPostDelete
44	CalendarEventDelete
45	HelDeskMessageCreated
46	HelpDeskCommentCreated
47	CheckinCreated
48	CheckinUpdated
49	CheckinDeleted
50	CoworkerDelete
51	CoworkerMessageCreate
52	DeliveryCreated
53	DeliveryAssigned
54	ProposalCreated
55	ProposalUpdated
56	ProposalDeleted
57	TeamCreated
58	TeamUpdated
59	TeamDeleted
60	CoworkerContractUpdate
61	AccessControlUpdate
62	CoworkerContractCreate
63	FailedCheckin
64	VisitorDeleted
65	CoworkerInvoiceLedgerEntryCreate
66	CoworkerInvoiceLedgerEntryDelete
67	CoworkerInvoiceLedgerEntryUpdate
68	CoworkerProductCreate
69	CoworkerProductUpdate
70	CoworkerProductDelete
71	FloorPlanDeskCreate
72	FloorPlanDeskDelete
73	FloorPlanDeskUpdate
74	TariffCreate
75	TariffDelete
76	TariffUpdate
77	CoworkerContractDelete
78	FloorPlanCreate
79	FloorPlanDelete
80	FloorPlanUpdate
81	ProductCreate
82	ProductDelete
83	ProductUpdate
84	BusinessUpdate
85	CommunityGroupCreate
86	CommunityGroupDelete
87	CommunityGroupUpdate
88	CoworkerPaymentMethodCreate
89	CoworkerPaymentMethodDelete
90	CoworkerPaymentMethodUpdate

Request Body

Required Fields

integer

required

The Id of the WebHook record to update.

BusinessId

integer

required

ID of the location this webhook belongs to.

Name

string

required

Display name for the webhook.

Action

integer

required

The event that triggers this webhook (e.g. CoworkerCreate, BookingCreate, CoworkerInvoicePaid).

URL

string

required

The endpoint URL that receives the HTTP POST payload when the webhook fires.

Optional Fields

Description

string

Optional description of the webhook’s purpose.

Active

boolean

Whether the webhook is enabled and will fire when the configured action occurs.

Code Examples

curl -X PUT \
  "https://spaces.nexudus.com/api/sys/webhooks" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "BusinessId": 0,
    "Name": "",
    "Action": 0,
    "URL": "",
    "Id": 87654321
}'

Response

200

Status

integer

HTTP status code. 200 on success.

Message

string

A human-readable message confirming the update.

Value

object

Contains the Id of the updated record.

WasSuccessful

boolean

true if the webhook was updated successfully.

Errors

array

null on success.

Example Response

{
  "Status": 200,
  "Message": "WebHook was successfully updated.",
  "Value": {
    "Id": 87654321
  },
  "OpenInDialog": false,
  "OpenInWindow": false,
  "RedirectURL": null,
  "JavaScript": null,
  "UpdatedOn": "2025-01-15T10:30:00Z",
  "UpdatedBy": "admin@example.com",
  "Errors": null,
  "WasSuccessful": true
}

400

Message

string

A summary of the validation error(s), in the format PropertyName: error message.

Value

any

null on validation failure.

Errors

object[]

Array of validation errors.

Show child attributes

AttemptedValue

any

The value that was submitted for the field, or null if missing.

Message

string

The validation error message.

PropertyName

string

The name of the property that failed validation.

WasSuccessful

boolean

false when the request fails validation.

Example Response

{
  "Message": "Name: is a required field",
  "Value": null,
  "Errors": [
    {
      "AttemptedValue": null,
      "Message": "is a required field",
      "PropertyName": "Name"
    }
  ],
  "WasSuccessful": false
}

Delete WebHookDelete an existing WebHook record by its Id.

Update WebHook

curl --request PUT \
  --url https://spaces.nexudus.com/api/sys/webhooks \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "Id": 123,
  "BusinessId": 123,
  "Name": "<string>",
  "Action": 123,
  "URL": "<string>"
}
'

{
  "Status": 123,
  "Message": "<string>",
  "Value": "<any>",
  "WasSuccessful": true,
  "Errors": [
    {
      "AttemptedValue": "<any>",
      "Message": "<string>",
      "PropertyName": "<string>"
    }
  ]
}

​Authentication

​Enums

​Request Body

​Required Fields

​Optional Fields

​Code Examples

​Response

​200

​400

Authentication

Enums

Request Body

Required Fields

Optional Fields

Code Examples

Response

200

400