Webhooks

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:

1. Navigate to Settings → Webhooks within GovDash.

2. Under the Webhooks section, you can create and configure new webhooks for your organization by clicking Add New Webhook.

3. 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.

As of July 2025, GovDash supports the following event types:

• v1.opportunity.create

• v1.opportunity.update

• v1.opportunity.delete

You can always access the most up-to-date event schemas from your dashboard, but for quick reference, here’s a direct link to the schemas as of June 29, 2025.

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_ID

• Field 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 include the GovDash_Opportunity_ID field — or an equivalent column mapped to externalCRMIdentifier. Doing this ensures that when new opportunities are later created via webhook-triggered processes, GovDash can properly recognize and track changes on those records.

Important: Without this field in place, GovDash will not be able to push changes from Salesforce to GovDash on opportunities that were created within GovDash first.

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: