Skip to content

Webhooks

Webhook configuration and event notifications.

Altegio sends real-time HTTP POST notifications to your configured URLs when events occur in subscribed locations. Each notification contains a JSON payload with the event envelope (company_id, resource, resource_id, status) and the full resource data.

Delivery details:

  • Method: POST
  • Content-Type: application/json
  • Delivery delay: ~5 seconds after the event
  • Your endpoint must respond with a 2xx status code

Configuration: Use the Webhook Settings endpoint to subscribe to specific resource types.

Retry behavior:

  • If your endpoint returns a non-2xx status or times out, the delivery is considered failed
  • Failed deliveries are not retried automatically
  • Webhook delivery timeout: 15 seconds
Operations
Webhooks

Get event notification settings

Request

Security
BearerPartnerUser
Path
location_idnumberrequired

location ID

Headers
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

curl -i -X GET \
  '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: string'

Responses

OK

Bodyapplication/json
successboolean

Execution success status (true)

Example:true
dataobject

Object with data

Example:
{
  "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,
  "goods_operations_sale": 1,
  "goods_operations_receipt": 1,
  "goods_operations_consumable": 1,
  "goods_operations_stolen": 1,
  "goods_operations_move": 1,
  "finances_operation": 1
}
metaArray of objects

Metadata (empty array)

Example:
[]
Response
{
  "success": true,
  "data": {
    "urls": [ … ],
    "active": 0,
    "salon": 1,
    "service_category": 0,
    "service": 1,
    "good": 1,
    "master": 1,
    "client": 1,
    "record": 1,
    "goods_operations_sale": 1,
    "goods_operations_receipt": 1,
    "goods_operations_consumable": 1,
    "goods_operations_stolen": 1,
    "goods_operations_move": 1,
    "finances_operation": 1
  },
  "meta": []
}