Adding an External Subscription

	This is the Copy icon
	This is the Help icon

1. Once you select the External type, enter a name for the subscription. You may want to use a name specific enough that you can easily identify it in the list (such as Receiving Entrance Swipe).

2. Next, use the drop-down list to select a category. The category will provide additional information about the subscription and will improve sorting. (Refer back to the earlier topic for category definitions.)

3. To add tags (available with Orchid Recorder versions 24.9 and later), click the + icon under Event Subscription Tags.

When the New Event Subscription Tags section appears, you will have the ability to assign a new or existing tag to this subscription. (All of the subscription tags that have been created on this Orchid Recorder will appear in a list for easy selection.)

4. To add a new tag to the system, click into the Event Subscription Tag Name field.
   1. Type the new tag name into the field.
   2. Click on it to select it.
   3. If you want to add a value to this tag (which will further define the tag), click the expand icon to the right of the Event Subscription Tag Name field.
      1. Then type the value in the Event Subscription Tag Value field.
   4. If this is the only tag you need to add, move to step 8.
   5. If you want to add another tag to this subscription, click the Add Tag button.
5. To select an existing tag, click on one of the tags in the list.
   1. If you want to add a value to this tag (which will further define the tag), click the expand icon to the right of the Event Subscription Tag Name field.
      1. Then type the value in the Event Subscription Tag Value field.
   2. If this is the only tag you need to add, move to step 8.
   3. If you want to add another tag to this subscription, click the Add Tag button.
6. To remove a tag from the selected subscription, click the X to the right of the tag name.
7. To clear a tag from the list, select the tag, then click the Trash Can icon to the right of the list.

8. Click Next to continue.

The next screen will allow you to select one or more associated cameras.

9. Select cameras that may provide video relevant to the event.
   1. Adding associated cameras is optional, but adding video to an event notification makes for a powerful combination.
   2. Video available in the Event Viewer will be limited to the cameras you select here.
   3. You may need to scroll down or move to another page to find the camera you want to use. (Use the paging toolbar, if needed.)

10. When you’re finished selecting cameras, click Next.

11. The last step is to review your selections.
    1. If you need to change anything, click on the step you want to return to (Information or Associated Cameras).
    2. Notice that the system has inserted a placeholder for a Webhook API URL. (Reference the next paragraph for more info.)
    3. When you are satisfied with your settings, click Save Subscription. The new subscription will be added to the Event Subscriptions list.

When you save the External subscription, the system creates a Webhook API URL that contains the subscription ID. The external system will need this URL to send updates to Orchid Recorder.

12. For the next step, click on the new external subscription in the list. The configuration dialog for the subscription will open.

As you can see, the Webhook API URL for this subscription has been created. (The Webhook API URL now has a defined value.)

13. Click the Copy icon to copy the Webhook API URL.
14. Now you can paste the URL into the webhook settings on the external system. This tells the external system where to send the event data.
15. Click on the Help icon for additional information on the proper format for the POST being sent by the external system.

*Be aware that some external systems will be able to send updates to Orchid Recorder directly, using the proper format. Other systems, however, will need additional configuration in order to format the POST so that it is compatible with Orchid. This may require additional software or code that works between the external system and Orchid.