Webhooks

A webhook is a user-defined HTTP callback that is triggered when a particular event occurs at the source site. When the event occurs, the source site makes an HTTP request to the URL specified.

In simple words, webhook lets you to quickly perform actions in another service based on the changes happening to your transactions and records within Zoho Expense. A webhook is used to send out an event notification to another service.

Once youโ€™ve configured the URL, Zoho Expense will post the event as a JSON to your webhook URL. For example, if a report is reimbursed in Zoho Expense, then a notification is sent to the specified URL.


Create a Webhook

You can create a webhook for any change in transaction status or when a transaction is created or modified.

  1. Switch to Admin View.
  2. Go to Settings on the left sidebar.
    (OR)
    Click the Gear icon at the top right side.
  3. Click Actions under Automation.
  4. Switch to the Webhooks tab.
  5. Click + New Webhook on the top right corner.
    Create Webhook
  6. Enter the name and select the module for your webhook.
  7. Enter a description.
  8. Next, enter the URL (URL of the external service providerโ€™s API) and select the types of event for which the webhook has to be triggered.
  9. Enter the next set of fields.
    • The fields are described below:
      Field Name Description
      Method Select type of API method: POST, PUT or Delete. By default, the system selects the POST method. POST: Requests that the data sent must be considered as new. PUT: Requests that the data sent should be considered as a modified version of the one already present. DELETE: Requests that the data be deleted.
      Custom Parameters You can add custom parameters. In the webhook such as AuthToken, Security Token, API Key, etc. based on which the URL will be appended. Enter the required parameter under Parameter Name and the corresponding value under Parameter Value. If you wish to add multiple parameters, select + Add Custom Parameters.
      Entity Parameters Append All Parameters: Select this option to send all parameters from Zoho Expense to the external service. Append Selected Parameters: Select this option to send selected parameters from Zoho Books to the external service.
      URL Preview The URL generated for this webhook will be displayed here.
  10. Click Save.
    Create Webhook

Edit Webhook

You can make changes to an already scheduled tasks. To edit:

  1. Switch to Admin View.
  2. Go to Settings on the left sidebar.
    (OR)
    Click the Gear icon at the top right side.
  3. Click Actions under Automation.
  4. Switch to the Webhooks tab.
  5. Hover over the webhook you want to edit and click the More icon next to the webhook.
  6. Click Edit and make the necessary changes.
  7. Click Save.
    Edit Webhook

Delete Webhook

To delete a webhook:

  1. Switch to Admin View.
  2. Go to Settings on the left sidebar.
    (OR)
    Click the Gear icon at the top right side.
  3. Click Actions under Automation.
  4. Switch to the Webhooks tab.
  5. Hover over the webhook you want to delete and click the More icon next to the webhook.
  6. Click Delete.
    Delete Webhook
  7. In the popup that opens, click Delete again to delete the webhook.
Get a personalized demo from our experts

Attend a demo and receive $50 worth of Zoho Wallet credits that you can use to subscribe to Zoho Expense!

credit-coins-illustration
*
*
*
*
*
*

By clicking Submit, you agree to our Privacy Policy.