Integration Setup Tutorial

• → Introduction
• 1. NomaSign Account
• 2. Integration Account
• 3. Signing Template
• 4. Refresh Token
• 5. Webhooks

Receiving Webhook Notifications

You can send documents via API without webhooks. Webhooks add real-time notifications when signing events occur.

Overview

When a signing session changes state, NomaSign delivers an HMAC-signed POST to your configured webhook endpoint. Your server verifies the signature and processes the event.

Prerequisites

• Your Webhook Secret (generated in Step 4)

Local Development with Dev Tunnels

To receive webhooks locally, you need a public URL that tunnels to your backend.

devtunnel user login
devtunnel host -p 5203 --allow-anonymous

Configuring in NomaSign

1. Go to Integration page in the NomaSign web app
2. Edit your integration entry
3. Set your Webhook URL (must be HTTPS)
4. Use Send Test Event to verify your endpoint works

Step 1: Create a tunnel in VS Code

Start a new dev tunnel in VS Code so your local webhook endpoint can be reached from the internet.

Step 2: Add the port to the tunnel

Add your local backend port to the tunnel configuration so webhook requests can route to your app.

Step 3: Make the tunnel public

Change tunnel visibility to public so NomaSign can deliver webhook events to your endpoint.

Step 4: Copy the tunnel URL and add it to your integration

Copy your tunnel URL and paste it into the integration's webhook URL field.

Verifying It Works

1. Start your backend (dotnet run)
2. Start the tunnel
3. Set webhook URL in NomaSign to tunnel URL + /api/signing/webhooks/nomasign
4. Click Send Test Event in NomaSign
5. Check backend logs for the received event