How to enable PicThrive

1. From the client’s Dashboard, go to Settings > Users & Permissions and create a new user called “PicThrive Webhook”. Give this user the highest permission group available.
   If you see the Partner Permission, please make sure you DO NOT select this.

2. Within the settings of that new “PicThrive” user, navigate to the Webhook tab, you will Add Webhook and name it “PicThrive Webhook” , select the Bookings only webhook schema and check the “Update Bookings” box. Under Webhook URL you will paste PicThrive’s Webhook. PicThrive’s Webhook URL will be the same for every FareHarbor client: https://api.picthrive.com/v1/Res/Fareharbor The Webhook URL is essentially the address where PicThrive will receive the client’s booking details. Once this URL is plugged in, the webhook is immediately activated, and PicThrive will begin receiving the booking details for any and every booking created on this Dashboard, in real-time.

3. Trigger the Webhook for existing bookings. Follow the steps here.

4. If a client is requesting an ADD ON option for their pictures, please follow these steps.
5. Once this is done, reply to PicThrive’s email, confirming that the integration has been enabled on the FareHarbor end.

A client may ask for a Photo Add on option. This can be done in 2 different ways and the client should be specifying which. If they don’t specify offer the following options:

1. Priced Custom Field checkbox (Preferred option). An example of what it should look like below (Price and verbiage is determined by the client): The client will let you know the price and tax. If not, please ask them to verify.
2. Photo Item. Only suggest with Cart or suggested items. This should be something the client specifically asks for and it’s on them to design this.

The webhook will automatically send PicThrive for every booking moving forward, but action is still required in FareHarbor to send PicThrive for any existing bookings for future dates. Here are the necessary next steps to ensure that we send PicThrive for every future booking they need in their system.

1. Run a report to see existing bookings for future dates. Run a Detailed Bookings report in the charter company’s Dashboard to see all bookings for future availability dates. It is best to select a custom date range starting with today’s date and ending with two years from that date (or as far out as that company has future bookings).
2. Initiating the webhook for each future bookings: The Business Intelligence script can automate webhooks for companies with 100 or more future bookings (if there are fewer than 100 future bookings, follow these steps instead). To send an automation request to the Business Intelligence team:
   1. Click the Share button within your report, and copy the unique report URL:
   2. Paste that report URL into a FareHarbor Automation submission request form.
   3. In the Select Automation Type field, select Webhook Update.
   4. In the Date, automation can start field, enter today’s date.
   5. In the Maximum date of completion field, enter 5 pm of the next business day.
   6. In the Link to FareHarbor report of bookings field, paste the URL of your future bookings report.
   7. Reference this help page for more information about submitting this type of form.

When there are fewer than 100 future reservations, the webhook can be triggered by opening each booking in the report and “touching” the booking:

1. Open the booking and click Edit contact.
2. Remove and re-add the contact information by cutting and pasting.
3. Save your changes to trigger the webhook.

Watch video example.

1. Check to see if the client’s Dashboard has an “PicThrive” User, and check that the Webhook URL in their API key has a Webhook URL.
2. Webhook activity will also be shown within the history of each individual booking in that Dashboard. For example, after a booking is created, the next event in that booking history should read: External API Booking Webhook request succeeded (PicThrive: PicThrive).

Note: All webhook activities in a booking are visible to Admins only.

1. Go to the Dashboard’s settings and select Users & Permissions.
2. Select PicThrive Webhook > Edit.
3. Select API Keys > Edit.
4. Select Delete API Key.
5. Once the API Key has been deleted, deactivate the PicThrive Webhook user:
   1. Within the PicThrive Webhook user, select Account.
   2. Select Permissions.
   3. Update user status to deactivated.
   4. Click Save.