Change Event Notification Settings

Request

Replace the complete location-wide URL set and apply one event-flag set to every supplied destination. Omitted flags default to 0. Requires webhook settings read access and permission to edit the location. A location-level webhook feature restriction can also deny the write. Read url_settings first: existing URLs may have different flags, and this POST overwrites them all. The response reports saved configuration, not delivery success.

Security

BearerPartnerUser

Path

location_idnumberrequired

location ID

Acceptstringrequired

e.g. application/vnd.api.v2+json

Example:application/vnd.api.v2+json

Content-Typestringrequired

application/json

Authorizationstringrequired

Bearer partner_token, User user_token

Bodyapplication/jsonrequired

activenumberrequired

1 - notifications are active, 0 - not active

Example:0

urlsArray of strings, non-emptyrequired

Complete replacement list: 1–10 distinct nonempty URLs after trimming and duplicate removal. The backend checks only for an http or https prefix; supply a valid HTTPS URL for each receiver.

Example:

[
  "https://dev.tools.test.com/test/Hooks"
]

salonnumber

1 - send events by location entity, 0 - do not send

Example:1

service_categorynumber

1 - send events by service category entity, 0 - do not send

Example:0

servicenumber

1 - send events by service entity, 0 - do not send

Example:1

goodnumber

1 - send events by product entity, 0 - don't send

Example:1

masternumber

1 - send events by team member entity, 0 - don't send

Example:1

clientnumber

1 - send events by client entity, 0 - don't send

Example:1

recordnumber

1 - send events by appointment entity, 0 - do not send

Example:1

schedulenumber

1 - send schedule update events, 0 - do not send

Example:1

loyalty_cardnumber

1 - send loyalty card events, 0 - do not send

Example:0

goods_operations_salenumber

1 - send events by the product sale entity, 0 - do not send

Example:1

goods_operations_receiptnumber

1 - send events by the entity arrival of products, 0 - do not send

Example:1

goods_operations_consumablenumber

1 - send events by the consumable write-off entity, 0 - do not send

Example:1

goods_operations_stolennumber

1 - send events by the product write-off entity, 0 - do not send

Example:1

goods_operations_movenumber

1 - send events by the product movement entity, 0 - no send

Example:1

finances_operationnumber

1 - send events by entity financial operation, 0 - no send

Example:1

self_sendingnumber

1 - The webhook creator will receive events triggered by their own actions, 0 - The webhook creator will not receive events triggered by their own actions

Example:0

curl -i -X POST \
  'https://developer.alteg.io/_mock/en/developers/openapi/hooks_settings/{location_id}' \
  -H 'Accept: application/vnd.api.v2+json' \
  -H 'Authorization: Bearer <YOUR_Bearer {PartnerToken}, User {UserToken}_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "urls": [
      "https://dev.tools.test.com/test/Hooks"
    ],
    "active": 0,
    "salon": 1,
    "service_category": 0,
    "service": 1,
    "good": 1,
    "master": 1,
    "client": 1,
    "record": 1,
    "schedule": 1,
    "loyalty_card": 0,
    "goods_operations_sale": 1,
    "goods_operations_receipt": 1,
    "goods_operations_consumable": 1,
    "goods_operations_stolen": 1,
    "goods_operations_move": 1,
    "finances_operation": 1,
    "self_sending": 0
  }'

Responses

Created

Bodyapplication/json

successboolean

Execution success status (true)

Example:true

dataobject

Object with data

Example:

{
  "company_id": 123456,
  "urls": [
    "https://dev.tools.test.com/test/Hooks"
  ],
  "url_settings": [
    { … }
  ],
  "active": 0,
  "salon": 1,
  "service_category": 0,
  "service": 1,
  "good": 1,
  "master": 1,
  "client": 1,
  "record": 1,
  "schedule": 1,
  "loyalty_card": 0,
  "goods_operations_sale": 1,
  "goods_operations_receipt": 1,
  "goods_operations_consumable": 1,
  "goods_operations_stolen": 1,
  "goods_operations_move": 1,
  "finances_operation": 1,
  "self_sending": 0
}

metaArray of objects

Metadata (empty array)

Example:

[]

Response

{
  "success": true,
  "data": {
    "company_id": 123456,
    "urls": [ … ],
    "url_settings": [ … ],
    "active": 0,
    "salon": 1,
    "service_category": 0,
    "service": 1,
    "good": 1,
    "master": 1,
    "client": 1,
    "record": 1,
    "schedule": 1,
    "loyalty_card": 0,
    "goods_operations_sale": 1,
    "goods_operations_receipt": 1,
    "goods_operations_consumable": 1,
    "goods_operations_stolen": 1,
    "goods_operations_move": 1,
    "finances_operation": 1,
    "self_sending": 0
  },
  "meta": []
}