Create Webhook

Create Webhook

post

Creates a new webhook for the desired event. The remote endpoint must be HTTPS.

Header parameters

X-Violet-TokenstringRequired

X-Violet-App-SecretstringRequired

X-Violet-App-Idinteger · int32Required

Body

External Hook Event

idinteger · int32Read-onlyOptional

app_idinteger · int32Read-onlyOptional

eventstring · enumRequired

The event being triggered

Possible values:

remote_endpointstringRequired

Remote endpoint the webhook posts against.

statusstring · enumOptional

Status of the webhook

Possible values:

date_createdstring · date-timeRead-onlyOptional

Date of creation

date_last_modifiedstring · date-timeRead-onlyOptional

Date of last update

events_countinteger · int64Read-onlyOptional

7 day event count

failure_ratenumber · doubleRead-onlyOptional

7 day failure rate

temp_disable_msinteger · int64Read-onlyOptional

Temporary disable milliseconds

Responses

default

default response

application/json

post

HTTPcURLJavaScriptPython

POST /v1/events/webhooks HTTP/1.1
Host: sandbox-api.violet.io
X-Violet-Token: text
X-Violet-App-Secret: text
X-Violet-App-Id: 1
Content-Type: application/json
Accept: */*
Content-Length: 70

{
  "event": "ORDER_UPDATED",
  "remote_endpoint": "text",
  "status": "INACTIVE"
}

default

default response

{
  "id": 1,
  "app_id": 1,
  "event": "ORDER_UPDATED",
  "remote_endpoint": "text",
  "status": "INACTIVE",
  "date_created": "2025-07-30T10:53:49.856Z",
  "date_last_modified": "2025-07-30T10:53:49.856Z",
  "events_count": 1,
  "failure_rate": 1,
  "temp_disable_ms": 1
}