Webhooks send your new subscribers and form submissions to Zapier, Make, n8n or any other app that accepts webhooks. Each matching lead is sent within seconds, so you can pass it on to a CRM, a spreadsheet, Slack or anything else your app connects to.

Webhooks are part of NerdyTags Business. You add them on an automation, under Webhooks & Zapier. They aren't set up in Settings, on individual profiles, or in a personal NerdyTags dashboard. See Automations in NerdyTags Business.

Before you start

  • Create an automation first. Webhooks are added after the automation exists. The automation's triggers and filters decide which leads the webhook receives.

  • Your organization needs to be active, with a paid subscription or complimentary seats. When a complimentary period ends, the organization becomes read-only and webhooks stop sending.

  • Each seat includes 2 automations. Organizations with 10 or more seats get unlimited automations.

  • Each automation can have up to 2 webhooks.

Add a webhook

  1. Go to Automations and open an automation, or create one.

  2. Scroll to Webhooks & Zapier and click Add webhook.

  3. The Add a webhook window opens. Give it a Name. It's filled in as Zapier, so change it if you're using another app.

  4. Paste the Webhook URL from your app. It must start with https://. In Zapier, this is the Catch Hook URL.

  5. Click Add webhook.

A Webhook added window then shows your webhook's signing secret, with Copy and Done buttons. You don't need it for Zapier. You can view it again at any time. See Verifying webhook signatures below.

The new webhook shows its name, a shortened URL, an Active badge, a Send test button and an actions menu (the three dots).

Triggers (new email subscriber and new form submission) and profile filters come from the automation. Edit the automation to change which leads are sent.

Profiles you manage for clients are included only when the owner allowed integrations. See Managing client profiles with join codes.

The Integrations and Webhooks sections on an automation, with Connect buttons for apps, Add webhook, How to connect Zapier and Preview data

Connect Zapier

The How to connect Zapier steps are also on the automation's Webhooks & Zapier section. It takes about two minutes. For a step-by-step guide with screenshots, see Sending leads to Zapier.

  1. In Zapier, create a Zap and choose Webhooks by Zapier as the trigger, with the Catch Hook event.

  2. Copy the webhook URL Zapier gives you.

  3. In NerdyTags Business, open your automation, click Add webhook, give it a name and paste the URL. It gets the leads this automation matches.

  4. Click Send test on the webhook, then Test trigger in Zapier. Zapier shows the sample subscriber or form submission.

  5. Add the actions you want, such as a CRM, a spreadsheet or Slack, and turn the Zap on.

Webhooks by Zapier is available on Zapier's paid plans.

Make, n8n and other apps

Make, n8n and other tools work the same way. Create a webhook trigger in your app, copy its webhook URL, and paste it when you add the webhook on your automation. Then use Send test to send a sample so you can map the fields.

See what gets sent

Click Preview data under See what gets sent to see the data for each event, field by field, so you know what to map in your Zap or app. Choose New subscriber or Form submission at the top. Switch between Fields and JSON, and click Copy JSON to copy the sample. The sample uses your organization's details. Real events contain the actual subscriber or submission.

The What gets sent window with New subscriber and Form submission choices, a note that the new subscriber event is sent when someone subscribes to a profile's email list, including when a past subscriber signs up again, Fields and JSON views, a Copy JSON button and the first fields of the sample

Fields in every event

Field

What it is

id

Unique ID for this event. Use it to ignore duplicates if an event is retried.

event

The type of event: subscriber.created or form_submission.created.

created_at

When the event happened (UTC).

test

true for samples sent with Send test, false for real events.

organization.name

Your organization's name.

organization.slug

Your organization's short name used in links.

profile.username

Username of the profile the event happened on.

profile.title

Display name of that profile.

profile.url

Public link to that profile.

New subscriber (subscriber.created)

Sent when someone subscribes to a profile's email list, including when a past subscriber signs up again.

Field

What it is

data.subscriber_id

The subscriber's ID in NerdyTags. It's 0 in test events.

data.email

The subscriber's email address.

data.name

The subscriber's name, if they gave one.

data.phone

The subscriber's phone number, if they gave one.

data.source

Where they signed up, such as the subscribe widget.

data.resubscribed

true if this person had subscribed before and signed up again.

data.subscribed_at

When they subscribed (UTC).

Form submission (form_submission.created)

Sent when someone submits a contact or custom form on a profile. Every answer is included, labeled with the form's field names.

Field

What it is

data.form_name

The name of the form that was submitted.

data.submitter_email

The submitter's email, when the form asks for one.

data.fields

Every answer, keyed by the field's label. This is the easiest to map in Zapier.

data.field_list

The same answers as a list, with each field's label, type and value.

data.submitted_at

When the form was submitted (UTC).

Here's an example form submission:

{
  "id": "evt_0ff7debf5a78456eaa4b482c5ac5e030",
  "event": "form_submission.created",
  "created_at": "2026-10-03T16:36:47.067447Z",
  "test": true,
  "organization": { "id": 1, "name": "Acme Realty", "slug": "acme-realty" },
  "profile": { "id": 1, "username": "acmerealty", "title": "Acme Realty", "url": "https://nerdyt.ag/acmerealty" },
  "data": {
    "submission_id": 0,
    "form_name": "Contact us",
    "link_id": 0,
    "submitter_email": "[email protected]",
    "fields": { "Name": "Jane Doe", "Email": "[email protected]", "Message": "Hi! I have a question." },
    "field_list": [
      { "label": "Name", "type": "text", "value": "Jane Doe" },
      { "label": "Email", "type": "email", "value": "[email protected]" },
      { "label": "Message", "type": "textarea", "value": "Hi! I have a question." }
    ],
    "submitted_at": "2026-10-03T16:36:47.067413Z"
  }
}

Manage a webhook

Each webhook on an automation has a Send test button on its row. Click it to send the sample from Preview data to your URL. You'll see "Test event delivered" with the HTTP status your app returned.

The webhook's actions menu (the three dots) has these options:

  • Recent deliveries: the last 50 events sent to this webhook in the past 30 days, with the status of each. Click an event to see its event ID, its attempts, the payload and the response, and you can retry a delivery from here. Click Refresh to update the list.

  • Edit: change the name and URL.

  • Signing secret: view the webhook's secret, or generate a new one.

  • Pause or Resume: stop sending for a while, then start again.

  • Delete: remove the webhook.

Deleting the automation removes its webhooks too.

How webhooks are delivered

  • Each event is sent as an HTTPS POST with a JSON body, within seconds.

  • Failed deliveries are retried for about 8 hours. Use the id field or the X-NerdyTags-Event-Id header to ignore an event you've already received.

  • The headers include X-NerdyTags-Event, X-NerdyTags-Event-Id and X-NerdyTags-Signature.

  • Send test delivers the same sample you see in Preview data to your URL, so you can set up your Zap or scenario before any real event happens.

When a webhook pauses itself

A webhook pauses itself if:

  • Your endpoint returns HTTP 410. Zapier sends this when a Zap is turned off.

  • 15 events in a row fail.

To start sending again, fix the problem (for example, turn the Zap back on), then choose Resume from the webhook's actions menu. Check Recent deliveries to see what went wrong and retry deliveries.

Verifying webhook signatures (for developers)

If you're receiving webhooks in your own code, check the X-NerdyTags-Signature header to make sure each request really came from NerdyTags. Apps like Zapier and Make don't need this.

  • Header format: t=<unix timestamp>,v1=<signature>

  • Algorithm: HMAC-SHA256, output as lowercase hex.

  • Signed string: <timestamp>.<raw request body>. Use the raw body bytes exactly as received. Parsing and re-serializing the JSON won't match.

  • Secret: each webhook has its own secret, starting with whsec_. It's shown when the webhook is created, and you can view or regenerate it at any time under Signing secret in the webhook's actions menu.

  • Compare in constant time, and reject requests whose timestamp is more than a few minutes old. NerdyTags doesn't enforce a time window itself, so it's up to your code.

  • Ignore duplicates using the X-NerdyTags-Event-Id header, or the id field in the body. Retries can deliver the same event more than once.

Here's an example in Node.js:

const crypto = require('crypto');
function verify(rawBody, header, secret) {
  const parts = Object.fromEntries(header.split(',').map(p => p.split('=')));
  const expected = crypto.createHmac('sha256', secret)
    .update(`${parts.t}.${rawBody}`)
    .digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1 || ''));
}