Arm and disarm with webhooks

Last modified: Tuesday July 01, 2025.

You can arm and disarm zones using webhooks.

  1. Open the Zones tool and add new schedule button create or edit a zone.
  2. Click ARM & DISARM.
  3. Under ARM BY SCHEDULE, select By External trigger.
  4. Open the dropdown and select a webhook or + Add new trigger:
    1. Click add new schedule button.
    2. Enter a name and click Add.
    3. Copy and save the Webhook address.
    4. Copy and save the Token.
    5. Click Done.
  5. To activate or deactivate the zone:
    1. Send an HTTP POST request to the webhook URL address.
    2. Set the authorization request header as Authorization: Bearer <webhook token>
    3. Set the request body as a JSON object:
      1. To arm the zone, use {"action":"activate"}
      2. To disarm the zone, use {"action":"deactivate"}
  6. Example cURL request:

    curl --location 'https://test-deployment.eu1.alta.avigilon.com/api/v1/public/ruleActivation/eyJzdWI-iOiI-xMjM-0NTY-3ODkwIiwibmF'
    --header 'Content-Type: application/json'
    --header 'Authorization: Bearer JIUzI1NiIsInR5cCI6IkpXVCJ9'
    --data '{"action": "activate"}'

  7. Example Windows Command Prompt cURL request:

    curl -H "Authorization: Bearer JIUzI1NiIsInR5cCI6IkpXVCJ9" ^
    -H "Content-Type: application/json" ^
    -d "{\"action\":\"deactivate\"}" ^
    https://test-deployment.eu1.alta.avigilon.com/api/v1/public/ruleActivation/eyJzdWI-iOiI-xMjM-0NTY-3ODkwIiwibmF

    1. Leave out the ^ carets if you enter the command in one line.
    2. Escape the internal double quotes around the JSON name/value pairs with backslashes: \"
  8. To edit a webhook, open the Zones tool and select zone settings button > external triggers button External triggers.

For more information about configuring webhooks, see Using external triggers and webhooks.