When you associate cameras with entrances, you can use access control events as [search query terms](https://help.camio.com/hc/en-us/articles/360029739872-How-do-I-connect-Openpath-to-Camio-tailgating-detection-contact-tracing-and-visual-verification#h_01G66E5AE79Z40BM169XEN7YBN). For example, you can quickly review every time Bob unlocked a door across any building on campus with the query https://camio.com/app/#search;q=bob\_jones\_entry.unlocked.

# Set up in 3 steps

The Openpath + Camio integration requires no network changes, no on-site visits, and no software installations. Also see [the ideal camera position for tailgating detection](https://help.camio.com/hc/en-us/articles/360034450552). The setup can be done from any web browser:

1. **[Configure Openpath](https://support.openpath.com/en_us/how-do-i-set-up-the-openpath-and-camio-integration-rkb7dVj8O) and optional read-only User Role.**  
If you'd like Camio to lookup user name and email for search and alerts, then create a read-only user role to be used by Camio when performing those lookups.
2. **[Assign each Camera to an Entry](/content/settings/integrations/openpath/index.html)**.  
Tell Camio which cameras see which entries at:  
[https://camio.com/settings/integrations/openpath](/content/settings/integrations/openpath/index.html)
3. **[Create Outbound Webhooks from Openpath to Camio](/content/settings/integrations/openpath/webhooks/index.html)**.  
This requires your Openpath Administrator's credentials at:  
[https://camio.com/settings/integrations/openpath/webhooks](/content/settings/integrations/openpath/webhooks/index.html)

Steps 2 and 3 are shown in this screencast:

[camio openpath 3 clicks](https://www.youtube.com/watch?v=b5CAo3HrZ9E)

# Settings

1. Either [sign in to Openpath with a read-only User Role](https://help.camio.com/hc/en-us/articles/360031101732) OR enter your Openpath **orgId** at:  
[**https://camio.com/settings/integrations/openpath**](/content/settings/integrations/openpath/index.html) 
2. Enter the numeric Openpath **entryId** values for each camera that has a view onto an access-controlled entrance and press the **Save** button. If you've entered a read-only userId for lookups, then you can select from the dropdown list as in this redacted example:

The use of a read-only **userId** and **token** is optional and used only to a) list available entryId values with descriptions and b) translate userId values into people's names.

# Searching

The access control events are indexed by userId, userId\_event, event, and status. For example:

|     |     |     |
| --- | --- | --- |
| **Example Search URL** | **event or status code** | **Description** |
| [https://camio.com/app/#search;q=entry.unlocked](/content/app/#search;q=entry.unlocked) | entry.unlocked | Show every entry.unlocked **event** across all doors. |
| [https://camio.com/app/#search;q=987\_entry.unlocked](/content/app/#search;q=987_entry.unlocked) | entry.unlocked | Shows every time **userId** 987 requested entry.unlocked **event**. |
| [https://camio.com/app/#search;q=SUCCESS\_\_ACCESS\_GRANTED](/content/app/#search;q=SUCCESS__ACCESS_GRANTED/index.html) | SUCCESS\_\_ACCESS\_GRANTED | Show every time the access **status** was "SUCCESS\_\_ACCESS\_GRANTED" |
| [https://camio.com/app/#search;q=entry.ajar.started](/content/app/#search;q=entry.ajar.started) | entry.ajar.started | Show anytime a door was left ajar. |
| [https://camio.com/app/#search;q=entry.ajar.ended](/content/app/#search;q=entry.ajar.ended) | entry.ajar.ended | Show times at which a door ajar was closed again. |
| [https://camio.com/app/#search;q=entry.forcedOpen](/content/app/#search;q=entry.forcedOpen) | entry.forcedOpen | Show any opening of a door without authorized access. |
| [https://camio.com/app/#search;q=entry.authenticated.failed](/content/app/#search;q=entry.authenticated.failed) | entry.authenticated.failed | Show invalid card attempts. |
| [https://camio.com/app/#search;q=entry.authorized.failed](/content/app/#search;q=entry.authorized.failed) | entry.authorized.failed | Show attempts forbidden by hour-of-day or other constraints. |

# API

For large deployments, the same settings are also accessible via the Camio API. The example above would be:

```
curl \
  -H "Content-Type: application/json" \
  -d '{"cameraMap":{"117550000798386757677:7CDD90CE5753:7CDD90CE5753.0":{"entryId":4557},"117550000798386757677:7CDD90CE5754:7CDD90CE5754.0":{"entryId":4558}},"orgId":663,"token":"xyzpdqz","userId":123}' \
  -X PUT https://camio.com/api/users/:user/settings/integrations/openpath
```

The JSON above formatted for legibility:

```json
{
"cameraMap": {
    "117550000798386757677:7CDD90CE5753:7CDD90CE5753.0": {
      "entryId": 4557
    },
    "117550000798386757677:7CDD90CE5754:7CDD90CE5754.0": {
      "entryId": 4558
    }
},
"orgId": 663,
"token": "xyzpdqz",
"userId": 123
}
```

Have more questions? [Submit a request](https://help.camio.com/hc/en-us/requests/new)