Webhook Basics

How do they work?

  • The DryMerge engine continually monitors an API endpoint for new data.
  • We compare data from the last check to the current check and identify any new elements.
  • If new elements are found, we trigger an API call to your internal endpoint with the new data.
  • If you want to check the current state of the data in between alerts, you can call our endpoint.

How do I get started?


Make an account.

If you haven’t done so already, follow the steps on getting started.


Set up the client.

Import and initialize the DryMerge client in your backend.

from drymerge import DryClient, DryId
client = DryClient(api_key="my-api-key")

Create your webhook

Look through our library of webhooks to find the one you want, and initialize it with the “Template” function in our SDKs. Depending on which template you use, it will look something like this:

my_user_id = '-exampleid'
client.template(DryId(name='new-spreadsheet-row-webhook', namespace='google', organization='DryMerge', type_='template'), {
    'identifier': f'{my_user_id}',
    'oauth_gateway': 'google/oauth-integration.gateway',
    'access_token': f'{{{{oauth.google/oauth{my_user_id}.connection}}}}',
    'spreadsheet_id': '1PokjiacviBzBGXcVnqqs0-SD8sWCxvKg2l3tLen4AkQ',
    'sheet_name': 'Sheet1',
    'webhook_url': 'https://api.drymerge.com/testing/reflect'
}, my_user_id')

(Optional) Set up user Oauth

If you haven’t already set up OAuth with your users (and thus lack their auth tokens), you can instead use DryMerge’s OAuth. Read about setup here.

If you’re creating an RPC instead of a traditional webhook, the steps will largely be the same. Check this page for more details. Check this page for a view of all ready-made RPCs.

Library of Prebuilt Webhooks

We’ve enumerated our library of existing webhooks here. We’ve focused on assembling webhooks for common SaaS services. Let us know if you’d a new webhook built for you — we can do it within a day. Alternatively, feel free to go to our engine reference for more details.