Send Webhooks

Webhooks allow you to send events that happen in Appraisal Inbox to your server or a 3rd-party platform like Zapier or Make and create any custom integration.

When active, Appraisal Inbox can send webhook events when the following resources are created, updated, or deleted:

• Appraisals

  • Tasks

• Invoices

• Clients

• Contacts

Note: Delete events only contain the ID of the deleted resource.

Activate Webhooks

1. From anywhere in Appraisal Inbox, click the icon in the upper right hand corner.

2. Click the Integrations tab then click "CONFIGURE" button.

3. Set the Destination URL (this is where Appraisal Inbox will send the webhook events).

4. The optional Signing Secret will be generated automatically for you. Use this to secure your webhook (see below for how).

5. Then, to specify which resources (appraisals, contacts, etc), click "Configure Events":

   

6. And to see the specific actions (on created, updated, deleted) per resource and their columns, click the section to expand it out. Be sure to click the "SAVE" button after making your selections:

Consuming Webhooks

When an event occurs that triggers a webhook, we will send an HTTP POST to the URL you specified, with a JSON-encoded body:

{

  "event_data": {
    "appraisal_file_number": "2025-0214",
    "appraisal_status": "Quote",
    "assignees": [
      "Angeline Bones"
    ],
    "client_name": "Awesome AMC",
    "created_at": "2025-12-11T19:15:36.738066Z",
    "id": "f967da5e-2199-4cf7-b48e-afb3555e50a3",
    "location_address": "1760 County Line Road, Lakeland, FL, USA",
    "property_type": "Commercial",
    "quote_fee": "750",
    "quote_made_date": "2025-01-11T19:14:46.859000Z"
  },
  "event_id": "f4423741-2144-43ba-987b-f5e29d35ba8f",
  "event_time": "2025-12-11T19:15:37.009260Z",
  "event_type": "appraisal.created"
}

Webhooks send only the fields you configure: create events include populated fields, update events include just changed fields, and delete events include the resource ID, only.

Note: The URL you specify to received webhook payloads should respond quickly with a 200 OK response code. To ensure you respond in a timely manner, it’s best to enqueue the body in a job queue to process asynchronously (rather than processing it in the request cycle). If we receive a non-2xx response code, we will retry several times.

Tip: To test webhooks and see what the data shape looks like for an event, you can use a webhook catching service like Webhook.site

Securing Webhooks

Optional, but recommended

Webhooks are sent over HTTPS and are signed with a secret key. The secret key is unique to each webhook and is used to verify the authenticity of the requests. This signing secret can be found alongside the webhook configuration in your account’s integration settings. Using the secret key, Appraisal Inbox signs the request body following the Standard Webhooks standard. The signature is included in the webhook-signature header.

Troubleshooting Webhooks

When a webhook cannot be delivered, Appraisal Inbox will notify you by email. Typical causes include an invalid or non-HTTPS URL, configuration mistakes, or errors while your system is processing the request. Be sure to correct your webhook settings and verify that you are receiving events correctly, otherwise you will continue to get the failure emails. If you need help with webhooks, please reach out to support.