Watchtower Public API Documentation

Q: Agency Settings

<h1 id="agencysettings">Agency Settings</h1> <h2 id="learnmoreaboutagencytab">Learn more about Agency Tab:</h2> <hr /> <a href="https://knowledge.yourwatchtower.com/en/article/adding-personnel-wgzil8/">Adding Personnel</a> <a href="https://knowledge.yourwatchtower.com/en/article/managing-resources-1bka57d/">Managing Resources</a> <a href="https://knowledge.yourwatchtower.com/en/article/managing-locations-qysq2m/">Managing Locations</a> <a href="https://knowledge.yourwatchtower.com/en/article/managing-assets-1ylgzmn/">Managing Assets</a> <a href="https://knowledge.yourwatchtower.com/en/article/managing-incident-categories-1t8ijfr/">Managing Incident Categories</a> <a href="https://knowledge.yourwatchtower.com/en/article/managing-groups-1l26lky/">Managing Groups</a> <ul> <li>Managing Workflows (if active) <a href="https://www.loom.com/share/f117244591d847508ceceeca164bfeb2">https://www.loom.com/share/f117244591d847508ceceeca164bfeb2</a></li> </ul> The Agency Tab is used to configure your agency. This includes adding new personnel, units, and position categories. The agency tab can be found below reporting on the left side menu bar: <img src="https://storage.crisp.chat/users/helpdesk/website/-/e/e/8/c/ee8c717f4fba7800/agencytabnavigation_f94t25.webp" alt="" />

Overview

The Watchtower Public API allows you to programmatically access your incident data. This REST API provides secure access to submission and dispatch information with flexible filtering and pagination options.

Base URL

https://api.yourwatchtower.com/api

Authentication

The API uses client credentials authentication. You'll need to generate API credentials from your Watchtower account.

Generating API Credentials

Log into your Watchtower account
Navigate to Account Settings
Go to the Security section
Click Generate New API Credentials
Provide a descriptive name (e.g., "Mobile App Integration")
Important: Copy and save the Client Secret immediately - it won't be shown again!

Authentication Headers

Include these headers in all API requests:

X-Client-Id: your_client_id_here
X-Client-Secret: your_client_secret_here

Endpoints

GET /incidents

Retrieves incident data with optional filtering and pagination.

Request Headers

| Header | Required | Description | | ---- | | X-Client-Id | Yes | Your API client ID | | X-Client-Secret | Yes | Your API client secret |

Query Parameters

| Parameter | Type | Required | Default | Description | | ---- | | startDate | string | No | | Filter incidents from this date (ISO 8601 format) | | endDate | string | No | | Filter incidents to this date (ISO 8601 format) | | categoryLabel | string | No |

Question 2

Introduction

Accepted Answer

Platform Introduction

👋 Welcome to the Watchtower documentation. Here you will find everything you need to set up and use Watchtower. There will also be some extra help and tips for some of the common hang-ups we hear from our users.

Need help?

If you need any extra help or think there is something we missed in the documentation, please contact us at help@yourwatchtower.com.

Pulse

| 💡 Pulse is a BETA feature. You receive access to the this feature free of charge. However, we may change, remove, or improve this feature at any time.

Pulse is a tool built for viewing and maintaining real-time status of your Locations, Resources, Personnel and Asset statuses. Think of it as "Asset Tracking" but more flexible and across your entire organization.

Video Tutorials 🚀

1. Introduction of the Pulse Tab

https://www.loom.com/share/8acf797fa15e4b6a8502283a4818856

Who uses it?

Administrators will access this tab when viewing and maintaining status information. Staff members are not able to access Pulse

Question 4

Adobe Acrobat Pro Guide

Accepted Answer

Adobe Acrobat Pro Guide

Use Adobe Acrobat Pro to manage your PDF Template Design

Adobe Acrobat Pro is typically the best tool to create and edit PDF templates, although Adobe requires a subscription and can be somewhat challenging to learn.

||| 🚨 The PDF files can be notoriously hard to edit and manage. Although Adobe owns and maintains the PDF file format, even their own PDF editing tool (Adobe Acrobat Pro) has many known quirks and bugs, which can be extremely frustrating at times. Please don’t hesitate to reach out to Watchtower support if you get stuck during this process. support@yourwatchtower.com 714-316-973

Getting started with Adobe Acrobat

Open your PDF template in Adobe Acrobat File > Open > [Select Your PDF]

Use the “Prepare a Form” tool, which is where new form inputs are created and edited.
From the All Tools list, select “Prepare a Form”.
Notice form inputs are now clickable and editable. If the PDF template does not already have inputs, add them using a Text Field Form Component. Make sure

Question 5

Managing Groups

Accepted Answer

Managing Groups

| 💡 Groups are similar to Tags because they help organize items within your platform. The difference is groups categorize your platforms resources and locations shown in the Submit and Dispatch tabs. Create, edit, and archive your groups in this tab.