IP Geo Data Precision

When available, location data is passed through webhooks that power notifications of suspicious activity to your users

The Castle webhooks can power automated notifications to your customers when there is some action they need to take in order to secure their account. Your app listens for these webhooks so that it knows when to send an end user notification, usually in the form of an email, and what information it should include in that notification.

City and Region Parameters

When the location of a device can be determined at login, the notification to the customer can use this information to help the user decide whether a specific login attempt could have originated from one of their devices. The webhooks pass a location object containing city, region, and other data when available.

It is important to know that this location data is approximate and is completely unavailable about 10% of the time.

The formatting of a notification to the customer must take these caveats into account. Specifically, the city and region parameters will show null when location data is not available. When the information is available, the notification should be worded in such a way that the user will understand that the location is approximate. For example, it may name a city nearby rather than the actual city that the device connected from at the time of login.