Articles in this section
Authenticate Emails with SPF, DKIM, and SenderID Auto-forwarding your emails to Vtiger Automate Outgoing Emails in Email Settings Automation - Approvals Automation - Assignment Rules Automation - Multi-path Workflows Automation - Scheduled Workflows Automation - Scheduler Automation - Standard Workflows Automation - Webforms Automation - Workflow Action - Create Event Automation - Workflow Action - Create Records Automation - Workflow Action - Create Task Automation - Workflow Action - Invoke Custom Function Automation - Workflow Action - SMS Task Automation - Workflow Action - Send Mail Automation - Workflow Action - Update Fields Automation - Workflows - Vtiger Expressions Configuration - Business Hours Configuration - Company Details Configuration - Consents Configuration - Customer Portal Configuration - Maps Configuration - Usage Details Configure Encrypted data fields in Vtiger CRM Configure Picklist Dependencies Considerations for Deactivating Vtiger Users Control Fields and Record Displays using Configuration Editor Create Reminders for Records and Inbox Create a field of a Grid type Customize your self-service portal theme using CSS styles Dealing with Currencies and Taxes Enable Desktop Notifications on Chrome Web Browsers Extensions - Extension Store IMAP Configuration - 2-way sync between Vtiger and IMAP providers Inventory - Payments and Subscriptions Inventory - Tax Management Inventory - Terms and Conditions Login to Vtiger on SSO SAML using ADFS Mailroom Functionality in Different Scenarios Manage Multiple Currencies Marketing & Sales - Forecast and Quota Settings Marketing & Sales - Pipelines and Stages Marketing and Sales - Deal to Project Mapping Marketing and Sales - Lead Conversion Data Mapping Marketing and Sales - Profile Scoring Module Management - Labels Editor Module Management - Module Numbering My Preferences My Preferences - Calendar Settings My Preferences - My Tags My Preferences - Notification Preferences SAML Support in Vtiger CRM Set up Mailroom Settings - Configure Module Settings Settings - Create Dynamic Fields and Layouts Module Management - Creating a Relationship Between Modules Settings - Customize Records and Fields for your Business Settings - How to set email autoresponder to Webform submission? Settings - Left Menu Settings - Manage Global Picklists in Vtiger Settings - Set up your Support Team Settings - Start Up Page Settings - Working with Picklist Values Module Management - Module Builder Support - SLA Policies Troubleshooting Login Issues Unsubscribe your Email User Management - Authentication User Management - Encrypted Field Access Logs User Management - Groups User Management - Login History User Management - Profiles User Management - Roles User Management - Settings Log User Management - Sharing Rules User Management - Users User Management - Vtiger Support Access Vtiger Buzz - Chrome Extension for Notifications Vtiger Implementation wizard Vtiger Language Support Websense - Trackers Websense - Widgets Configuration - Storage Guard Adding a local DNS Entry Adding Additional Hidden Fields to a Webform Configuring Dependent Fields and Blocks for Modules Duplicate Prevention in Modules Module Management - Modules Module Management - Module Layouts & Fields

Automation - Workflow Action - Webhook

Sabqat Ruba
9 Mar, 2021 - Updated 6 months ago


A webhook is a user-defined HTTP callback that is triggered when an event occurs. A web application that implements webhooks will POST a message to a URL when a particular event occurs at the source site. 


In simple terms, you can alter or augment the behavior of a web page or a web application by using custom callbacks with a webhook method.


To learn more about webhooks, click here.


Why webhooks

You can use webhooks to notify your software application of changes that occur in Vtiger.


Business scenarios: 

  • Closed a potential deal in Vtiger? Then use webhooks to push customer information to a third-party application (maybe an accounting software) to automatically generate an invoice.
  • You can push a newly created lead to a marketing list in your email marketing application.

How webhooks work

Webhooks help in communicating with third-party applications by sending instant web notifications. With webhooks, you can configure HTTP URLs and associate them with workflow rules to automate the notification process.


Webhooks supports all workflow-enabled modules. 

Feature Availability


Sales/Help Desk Professional

Sales Enterprise

Help Desk Enterprise

One Professional

One Enterprise

Feature Availability



Calls per user






Calls per day






Setting up Webhook Action

Let us learn how to set up webhooks by considering Freshbooks as the third-party accounting software. 


Follow these steps to set up webhook action:

  1. Click the User Menu on the top right corner of the screen
  2. Click the Settings button
  3. Look for the Automation section
  4. Select Workflows
  5. Click the +New Workflow button
  6. Select Standard
  7. Specify the basic information, workflow trigger, and entry criteria. To learn about them, click here
  8. Set up the webhook action by clicking the Add Action drop-down
  9. Select Webhook 
  10. Enter the Action Title and Description
  11. Specify the URL of the third-party application under URL to Notify
    • This supports two methods: 
      1. POST - Creates a record in third-party
      2. PUT - Updates a record in third-party
    • In our example, the closed deal’s data is sent to Freshbooks to create an invoice
    • Example URL: POST -
  12. Select the format in which you want to notify under Content Type
    • Vtiger supports four content types: XML, JSON, JSONARRAY, and FORM
  13. Choose the Authorization Type
    • Select the Basic Authentication radio button if the third-party provides an authenticated service. Otherwise, choose No Authentication
    • If you choose Basic Authentication, then you must specify the username and password for the third-party account
  14. Provide the entity Parameters of the third-party and their values that you want to push. 
    • You must enter the following for the example considered: Accounting Software ID, Account ID, Public ID, Authtoken, Fields present in third-party and their respective values in Vtiger
  15. Click Save


  •  You can add up to three webhooks per workflow.
  • You must add all the fields present in the third-party as parameters during the configuration.
  • Authentication fields and Public ID are the mandatory parameters.

Webhook Logs

Vtiger records every activity triggered when the configured event occurs. The log tables help you track the data that you send to the third-party application.


Follow these steps to view webhook logs:

  1. Click the User Menu on the top right corner of the screen
  2. Click the Settings button
  3. Look for the Automation section
  4. Select Workflows
  5. Open the workflow that has the webhook action configured
  6. Scroll down to the Actions section of the workflow
  7. Click the View Webhook log link shown beside the action

You will see the following details in a webhook log. You can filter the log according to different statuses.


Different log statuses

Here are the different log statuses:

  • Queued: When the data is yet to be dispatched 
  • Dispatched: When the data has been dispatched to the third-party 
  • Success: When the data has been delivered to the third-party
  • Failed: When webhook fails to send the data



  1. The web notifier service handles retries. There can be three retries: 
    • 1 hour for the first retry
    • 2 hours for the second retry
    • 4 hours for the third retry
  2. Every retry is logged in the webhook log.
  3. The record owner and all active admins are notified via email when a webhook fails.
Home Privacy Policy Terms of Service Security Center Policy & Legal Center Contact Us
© Copyright 2021 Vtiger. All rights reserved.
Powered by Vtiger
Facebook Twitter Linkedin Youtube