# Fishbowl Developer Hook

This documentation is for an older version of the API. We recommend using the REST API for Fishbowl Advanced.

## Install FishHook

The FishHook installer and some developer code samples for the Legacy API can be downloaded here. After completing the installation, FishHook can be opened from the program menu.

The default program location is C:\Program Files (x86)\FishHook\FishHook.exe.

## Login to the Fishbowl Server

When the Fishbowl Developer Hook is launched, a Login request tab will automatically be opened. If needed, the User Name, Password, Server Hostname, and Server Port can be configured by clicking the Settings menu and then selecting Change Connection.

With the login request open, click Connect and then click Send Request to log into the Fishbowl Server.

## Application approval

The first time that an integrated application attempts to connect to Fishbowl, the application will need to be approved. The app only needs to be approved once. Follow the steps below to approve an integrated app.

1. Start the Fishbowl Client and open the Settings module, located in the Setup group.
2. Click the Integrated Apps tab.
3. Select the integrated app from the list and then click the Approve button.
4. The integrated app should now be able to connect successfully.

## Send a request

Before sending a request, it is necessary to log into the Fishbowl Server. After logging in, click the Tabs menu at the top, select Add Request Tab, and then choose from the list of available requests.

If the login was successful, the request will already have the correct ticket key. After adding any necessary information to the request, click Send Request to send the request to the Fishbowl Server.

## Request response

After the Fishbowl Server processes a request, it will return a response to the Fishbowl Developer Hook.

By default, the XML response will be displayed in the lower pane of the main window. To make the response appear in its own window, click the File menu and then select Show XML Response.