Skip to main content

Webhooks

Seamlessly integrate and automate your procurement process by integrating Vendr with existing tech stack.

I
Written by IT_Admin Accounts
Updated over a week ago

This article applies to:

Admins

Free, Premium Procurement

Estimated time: Less than 5 mins

How it works

Our webhook integration empowers you to build your own integrations that can connect to Vendr to help you streamline your process. Subscribe to events of interest and when that specific action happens in Vendr, trigger actions in your external system. For example, when a user completes a security step in a Vendr workflow sync the custom fields and attachments to your security tool.

While Vendr supports integration via webhooks, it is important to note that they function one-directionally, primarily as a trigger system for external systems rather than ingesting data from them. This allows Vendr to send information and initiate processes but not receive data back from connected systems.

Vendr's webhook functionality has its limitations: It acts mainly as a sender to notify external systems or trigger actions and does not receive data from them. This design makes it feasible to automate workflows within the available scope but imposes constraints on data synchronization between systems like Vendr and others, such as Ironclad.

Requirements

  • Must be a Vendr admin

Install the integration

  1. Go to Admin and select All Integrations

  2. Search for Automation and then select Webhook

  3. Provide a unique name for your webhook. This name will be displayed on the integrations page

  4. Provide the URL for the API endpoint you want Vendr to make a request to

  5. [Optional] provide a string value in the secret to verify the authenticity of the request.

  6. Select Integrate to save the webhook

  7. Select the webhook event(s) you would like to subscribe to.

  8. [Optional] Select a sample event from the Test Payload section to send a test webhook. This is useful for testing the connection between Vendr and your API endpoint or to get a sample JSON payload to use for development.

Recommendations for Webhook Integrations

  • Use Webhooks as Triggers: Configure webhooks in Vendr to initiate events or processes in external systems like Ironclad based on predefined criteria.

  • Acknowledge Limitations: Understand that Vendr's webhooks primarily act as senders of information, not receivers. Recognize this when designing workflows.

  • Plan Thoroughly: Develop a well-documented and detailed workflow with clear requirements before implementation. This approach helps identify compatibility issues and integration requirements, streamlining the setup process.

View API documentation

For details on the webhook payload, schema, and field definitions, view the webhook models documentation.

Vendr Integration with Ironclad: Key Considerations

Vendr facilitates integration with Ironclad through webhooks, enabling the initiation of processes in Ironclad from within Vendr. Although there is no native integration, webhook events can be configured to perform specific tasks, such as triggering approvals or syncing custom fields. This requires careful planning to address limitations, as real-time, two-way synchronization is not achievable within this setup.

Did this answer your question?