Configuring webhook events ensures that Neo Agent receives notifications about the ticket activity that matters to your automation workflows.
Prerequisites
Before configuring webhook events, ensure you have:- Created an agent resource for Neo Agent
- Set up your API application with proper permissions
- Connected HaloPSA to Neo Agent
Configuring Webhook Events
1
Navigate to Webhooks
From your HaloPSA dashboard, go to Configuration → Integrations → Webhooks to access the webhooks management page.
You should see the Neo Tickets callback [ALL] webhook that was automatically created when you connected to Neo Agent.

2
Open the webhook configuration
Click on the Neo Tickets callback [ALL] webhook to open its configuration.
You’ll see the webhook details including:

- Webhook Name: Neo Tickets callback [ALL]
- Payload URL: The Neo Agent callback URL (automatically configured)
- Enabled: Should be set to Yes
3
Add webhook events
In the Events section, you need to configure which ticket events will trigger the webhook. Click the + Add button to add an event.
You’ll add multiple events to ensure Neo Agent is notified about all relevant ticket activity.

4
Add 'New Ticket Logged' event
Add an event for when new tickets are created:

- Select New Ticket Logged from the Event dropdown
- No additional criteria are needed for this event
- Click Save to add the event
This event triggers whenever a new ticket is created in HaloPSA, allowing Neo Agent to begin processing the ticket immediately.
5
Add 'Ticket Changed' event with criteria
Add an event for when tickets are updated. The “Ticket Changed” event requires you to add criteria to filter which changes trigger the webhook.

- Select Ticket Changed from the Event dropdown
- Note the warning: “You must choose at least one criteria”
- Click the + Add button to add criteria
6
Configure the Status criteria
Add a criteria to trigger the webhook when the ticket status changes:

- In the Field Name dropdown, search for and select Status
- Click Save to continue configuring the criteria
7
Set the criteria conditions
Configure how the status change should be evaluated:
Set the following values:

- Change Context: Select Value changed
- Rule Type: Select To any value
8
Review the configured event
After saving, verify that the Ticket Changed event shows the correct criteria:
The event should display:

- Field: Status
- Change Context: Value changed
- Rule Type: To any value
9
Add additional events (recommended)
For comprehensive ticket tracking, add the following additional events by repeating the “Add” process:
Recommended events to add:

| Event Name | Conditions | Purpose |
|---|---|---|
| New Ticket Logged | None | Triggers when a new ticket is created |
| Ticket Updated | Status changed to any value | Triggers on status changes |
| Ticket Updated by Agent | None | Triggers when an agent updates a ticket |
| Ticket Updated by User | None | Triggers when an end user updates a ticket |
Adding multiple event types ensures Neo Agent receives notifications for all relevant ticket activity, enabling comprehensive automation and monitoring.
10
Save the webhook configuration
After adding all desired events, click Save to update the webhook configuration.
Your webhook events are now configured! HaloPSA will send notifications to Neo Agent whenever the configured events occur.
Verifying Webhook Delivery
After saving your webhook configuration, you can verify that webhooks are being delivered correctly:- Navigate back to your webhook in Configuration → Integrations → Webhooks
- Click on the Neo Tickets callback [ALL] webhook
- Select the Deliveries tab to view webhook delivery history
- Create or update a test ticket to trigger a webhook
- Verify that the delivery shows a successful response
Troubleshooting
Webhook not found
Webhook not found
- Ensure you have successfully connected HaloPSA to Neo Agent
- The webhook is created automatically when the connection is established
- If the webhook is missing, try disconnecting and reconnecting your HaloPSA integration in the Neo Agent dashboard
Webhook not triggering
Webhook not triggering
- Verify the webhook is set to Enabled: Yes
- Check that you’ve added the correct events
- Ensure the criteria conditions match your expected ticket changes
- Create a test ticket to verify the webhook fires
Delivery failures
Delivery failures
- Check that your Neo Agent subscription is active
- Ensure there are no firewall rules blocking outbound connections from HaloPSA
- Review the delivery logs in the Deliveries tab for error details
Too many webhook notifications
Too many webhook notifications
- Review your event criteria to ensure they’re not too broad
- Add specific criteria to the “Ticket Changed” event to filter notifications
- Consider which events are truly necessary for your automation workflows
What’s Next?
With webhook events configured, Neo Agent will receive real-time notifications about ticket activity. You can now:- Create Workflows: Build automation workflows that trigger immediately when tickets are created or updated
- Configure Responses: Set up how Neo Agent should respond to different ticket events
- Monitor Activity: Track Neo Agent’s interactions with your HaloPSA tickets in real-time
Your HaloPSA integration is complete! Neo Agent will now receive instant notifications whenever the configured ticket events occur in your HaloPSA system.
