Using Webhooks in GovDash
GovDash supports webhooks to seamlessly notify external systems whenever opportunity records are created, updated, or deleted. These webhooks enable real-time synchronization, allowing your team to implement custom logic (such as updating Salesforce, SharePoint, or any external CRM) the moment an opportunity changes.
Webhook Management with Svix
GovDash leverages Svix to manage webhook delivery. Svix handles reliable event dispatching and provides robust observability into webhook activity. We recommend reviewing their documentation to understand how to consume and validate incoming webhook events: https://docs.svix.com/consuming-webhooks
Setting Up Webhooks in GovDash
To get started:
Navigate to Settings → Webhooks within GovDash.
Under the Webhooks section, you can create and configure new webhooks for your organization by clicking Add New Webhook.
After creation, click on the webhook name to:
Set up or update endpoint URLs
Monitor delivery attempts and event logs
Note: You'll need to have a server or endpoint ready to receive these events.
Event Schemas & Consumption
After your webhook is created, GovDash will begin sending events to your configured endpoint. You can view the payload structure (schema) of each supported event in the Event Catalog within the Webhooks Admin Dashboard.
.png)
As of July 2025, GovDash supports the following event types:
v1.opportunity.createv1.opportunity.updatev1.opportunity.delete
Sample Payloads/Schemas
If you’d like to see a sample of the webhook schemas/payloads, we have provided sample files using dummy data below:
Salesforce Webhooks
Important: You will need to configure the Salesforce integration before setting up webhooks for Salesforce. Please see our guide here for steps to configure the Salesforce integration.
Salesforce Bidirectional Sync: Custom Field Setup
To enable seamless syncing between GovDash and Salesforce, your Salesforce instance must include a custom field on opportunity records named:GovDash_Opportunity_ID
This field acts as a unique identifier that allows GovDash to track and update Salesforce opportunities that originated from GovDash.
Required Configuration
Field Name:
GovDash_Opportunity_IDField Type: Text
Field Length: 64 characters
Unique: Yes (should be configured as a unique field)
Why This Field Matters
If you import or sync existing Salesforce opportunities into GovDash, we strongly recommend that you ensure your GovDash_Opportunity_ID field in Salesforce is mapped to externalCRMIdentifier within GovDash. Doing so ensures that when new opportunities are later created via the webhook-triggered processes, GovDash can properly recognize and track changes on those records/opportunities.
Mapping your Salesforce GovDash_Opportunity_ID field to GovDash’s externalCRMIdentifier internal field is done within the Track Salesforce Fields section of the Capture Settings in GovDash. Below is an example of what the field mapping should look like:
.png)
Important: Without this field/mapping in place, GovDash will not be able to push changes from Salesforce to GovDash on opportunities that were created within GovDash first.
Validating Requests
You can verify whether incoming payloads came from our systems using the Svix Signing Secret provided within your dashboards:
.png)
Need Additional Information?
See the links below for more information on verifying webhooks:
FAQ
What are webhooks in GovDash?
Webhooks in GovDash notify external systems in real-time whenever Pipeline opportunity records are created, updated, or deleted.
Where in GovDash are webhooks supported?
Currently GovDash only supports sending data via webhooks in the Capture Cloud, specifically details within an opportunity’s Overview page, including your custom fields.
Does GovDash receive webhooks?
Not at this time. GovDash can only send webhooks to external systems through Svix.
How can I manage webhooks in GovDash?
GovDash uses Svix to manage webhook delivery, which provides reliable event dispatching and observability into webhook activity.
What steps do I need to follow to set up webhooks in GovDash?
To set up webhooks, navigate to Settings → Webhooks, click Add New Webhook, and configure your endpoint URLs and monitor delivery attempts.
What event types does GovDash support for webhooks?
GovDash supports the following event types: v1.opportunity.create, v1.opportunity.update, and v1.opportunity.delete.
How can I verify incoming webhook payloads?
You can verify incoming payloads using the Svix Signing Secret provided within your dashboards.
Where can I find more information on verifying webhooks?
You can find more information on verifying webhooks at the following links: https://docs.svix.com/receiving/verifying-payloads/how, https://docs.svix.com/receiving/verifying-payloads/how-manual, and https://docs.svix.com/consuming-webhooks.