> For the complete documentation index, see [llms.txt](https://help.openletterconnect.com/olc-help-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.openletterconnect.com/olc-help-docs/integrations/live-apps/zapier/qr-code-webhook-setup-in-zapier-for-olc.md).

# QR Code Webhook Setup in Zapier for OLC

Trigger an email notification (or Slack alert) when someone scans a QR code printed via Open Letter Connect. You’ll capture data via Zapier’s webhook and pull in UTMs.

#### What You’ll Need

✅ Access to  Zapier account\
✅ Open Letter Connect account with webhook access\
✅ An email (Gmail/Outlook) Slack, or any messaging app for test notifications

### &#x20;Step-by-Step Procedure

#### &#x20;Step 1: Set up Webhook Trigger in Zapier

1. In Zapier, create a new Zap
2. Trigger App: Webhooks by Zapier<br>

   <figure><img src="/files/quvwnVBv7uwg9N8LO62L" alt=""><figcaption></figcaption></figure>
3. Trigger Event: Catch Hook<br>

   <figure><img src="/files/lJhEea2ShsMsug1mMdfV" alt=""><figcaption></figcaption></figure>
4. Copy the webhook URL Zapier provides\ <br>

   <figure><img src="/files/cnQIFDVx34twXN3e8nSk" alt=""><figcaption></figcaption></figure>

5\.  Paste that URL into Open Letter Connect

<figure><img src="/files/fAR1tffaVd771VHS9gii" alt=""><figcaption></figcaption></figure>

* Locate the “Webhooks” section (Settings > Webhook)
* Paste the Zapier webhook URL
* Select “QR Code Scans” on the Event Types

#### Step 2: Add Email Notification Step

1. Add a new Action step in Zapier:\
   \
   App: Email by Zapier (or use Gmail if preferred)<br>

   <figure><img src="/files/MTqKCRoMvJKPvlGIk1Jy" alt=""><figcaption></figcaption></figure>
2. To: Your email<br>

   <figure><img src="/files/YeAQfxcHcq6wFt4WDGU2" alt=""><figcaption></figcaption></figure>

Subject:  QR Code Scanned: {{utm\_firstname}} {{utm\_lastname}}&#x20;

Body:\
A QR code was scanned!

\- First name: {{utm\_firstname}}

\- Last Name: {{utm\_lastname}}

\- Source: {{utm\_source}}

\- Time: {{data.scanned by contact last}}

<figure><img src="/files/oGrZuNps4Wx6C08jzO94" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Note: If the UTMs aren't populating, check:
{% endhint %}

* If UTM parameters are added to your mail piece in Template builder.\
  \
  **Go to Templates > Select Template > QR Codes and input/map your UTMs**\
  \
  Step 3: Test in Slack

  <figure><img src="/files/IZ9u0FrgDpPqqeqngb6f" alt=""><figcaption></figcaption></figure>

If you're using Slack instead of email:

1. Use Slack → Send Channel Message<br>

   <figure><img src="/files/VGfNqUDJSToVLiMTnq71" alt=""><figcaption></figcaption></figure>
2. Hook it up to your workspace and create a channel<br>

   <figure><img src="/files/oOsSRAvYiOaWaGQK16Rp" alt=""><figcaption></figcaption></figure>

   <figure><img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACsAAAAnCAYAAACWn7G7AAAFKElEQVR4AaxY7W4WRRQ+u7SAIaaYKiFRmih+1BbE/jbcgIleh4lejka9HuJvpQQLMfypITYCEWJIoFXX5zlzZubM7OzuW+NmZs45z3nOx867777t9P/8/XIYVpl/zfNGeab4U/gKPfT3f/5J7sV5l/qP2Y445QF9cY45ozwHY47WKfLEfLUcx96/ty/9u+9fkzQ/oH7d7F2TxPwkHjnX5KqPj3qRx8euquf8sbe3rrwt/Zm1NVlrzvWV8HWLnc4zlR/4Gcy1MxN11sTnvHDhVek7mb+G5M5aC1rKk2K80jEnIik8bjo8pgXRBxFXHxX0GDBI1CIXsgEBPcWwBBBDisoaIW/13pCiIWSQfJVWxv8vLeQfZCh6ENHNFwEurcdggGtpNDgK6bIUHPyemvSuahXUDhODTefHwAXAl0fCM/Tk8SN58Mvd8hWnr6rbJcZX3tQE/yD67HXGnE8e/54LRY09oNvcLO6AWPQnCVx1czLZ8+d/ypWtd2R752ObNyD3MGlTp6xnje/Jhyk+cJmTuVlDa8ZFe+ik14dBwqVYUMNDEnVKcz7945FcvvymnD33iuOYk7zxB6moTOJi16A5mZs1DMwCm9VP5vD1c4icnJwg6fmARA4SBSCvHlJdl+wfayHZ2XPntcbID3c/Av8LgEQ5LHQVIKcHwH0aOSJrgZ/tUltsdj68TBas2BUtr8NmsgoC6sasE8+so7bU+XAfwU6izfcldEB39m8LJywpHzk4pXUZbsIzws6aw4T3V/ocw99WF/rqRH64dUsnP3+NTgucml0B1cJiuImAhTW8DcxhInia6zKjGaavnC7dgARNwtUFMbnmm+mLuCIgk7grhevUxlJDjYRangtiKUDpMScGSOrh8xd1BcrFEpXgjLXAT24tqYvEDQ2PgTT2zkWFkASA7fhwlh51j5bEAT87uRHRCozCHV0m+9j1iLQAeDf1w8ND+fabr+W7aj57+kxLfW+459zZ34/lwWEWiNYI97H86kqxFpDshjJVLjbMkCkOfWnWtfBHDH09l7mZ4haqbG1tyRdffjWaGxc3ZAOz5bv+0Y12adRKdZUBADI3q15dAOcRaNme1srY0iqjVrFadXOz6tVllVwNThlbWg26g0Y3poAujiWtZ3ZMKiLUWIWjRFvm+fZIGheiw+RXrwrDzlYISeTOTs3WZtTplBX55jShLi7RTd1P4J6KZoF4wiq6z1Dzq3Sf3Lwpn372ubHMaUJ/hc0zJSKVfjRLcco5+tza8bwnfuP5psgMorAofCeA2oNEeCDQrP8VATgxwHUeVPGA10sWrNqJWKDl01ZzQFCIS+aj2c7i5pvuEF8MD3h99NkWziJFpjY4CumSYtAs9XAHpYt4OclaX1+X45cvSkeyyFjKkshiuyT+Oj5+IayRMeaEBaHNDq2ofNvKHLCyjYuvvSFHRw/LhumEX1IeA0zIihc34ei3h8IaOQRVmQffE20WZvaZNrDwYAb0wBlk8/VLwhO9Xw8fSH1IoeevenBhhx04yFBMz33rM1jYFc6czL25eSkWDlKLd9M/CuaX8lJUG7763u7okCIfeoRDi+2dPdnegb6LSVnP3fLggzm5GdgbVzbtWGg2m9RCQ4lNKBlzyspElyTW8rFeJxUcg/QUESZRTGjq0AU2BiCsi2Mot2ORXxJ8Ea8by6B0mDwYHmqaF1jCoftR4zkismpGxE2qWxcPmN4W+gWja1yMqITexf0bY2+JKT6oNhYY+HZLyi64Wnx/MyL/AgAA//8WyiLjAAAABklEQVQDAChKvGXbQZDKAAAAAElFTkSuQmCC" alt=""><figcaption></figcaption></figure>
3. Format the message with UTM fields. UTM fields can be found by clicking this: &#x20;

   <figure><img src="/files/ADNjePrHecEdBhzJ7Rut" alt=""><figcaption></figcaption></figure>

#### &#x20;Step 5: Publish&#x20;

* Once tested, click Publish Zap<br>

  <figure><img src="/files/j5L0a0RiN5d0gT2B32Dz" alt=""><figcaption></figcaption></figure>

#### ❓ What are UTM Parameters?

UTM parameters are small tags added to the end of a website link (URL).\
They help you track where your visitors are coming from and what marketing piece they responded to — like a postcard, email, or text message.

Think of them as little labels that tell your analytics tool who clicked and from where.

#### Why You Should Use Them

Using UTM parameters lets you:

* Know which marketing campaigns work best
* Measure responses from postcards, emails, or QR codes
* Match visitors or leads back to your mailing list
* Save time when analyzing campaign performance

#### What a Link With UTM Looks Like

Regular website link:

* [https://www.openletterconnect.com](https://www.openletterconnect.com/)

With UTM parameters:

* <https://www.openletterconnect.com/?utm_source=postcard&utm_medium=directmail&utm_campaign=dental_promo_nov2025&utm_firstname=John&utm_lastname=Doe&utm_address1=123_Main_St&utm_propertyaddress=123_Main_St>

### Let’s Break It Down

| Parameter            | What It Means                            | Example Value             | Why It’s Useful                              |
| -------------------- | ---------------------------------------- | ------------------------- | -------------------------------------------- |
| utm\_source          | The source — where the visitor came from | postcard, facebook, email | Shows which channel brought traffic          |
| utm\_medium          | The marketing type or channel            | directmail, social, email | Groups results by campaign type              |
| utm\_campaign        | The campaign name                        | dental\_promo\_nov2025    | Helps identify which campaign they came from |
| utm\_firstname       | The contact’s first name                 | John                      | Links response to your contact list          |
| utm\_lastname        | The contact’s last name                  | Doe                       | Same — helps match leads to data             |
| utm\_address1        | The mailing address                      | 123\_Main\_St             | Useful for matching mail recipients          |
| utm\_propertyaddress | The property the mail piece refers to    | 123\_Main\_St             | Tracks multiple property campaigns           |

#### How This Works in Practice

When you print a QR code on a dental campaign postcard, you can add UTM tags like these:

* <https://www.openletterconnect.com/?utm_source=postcard&utm_medium=directmail&utm_campaign=teeth_whitening&utm_firstname=Sarah&utm_lastname=Lopez&utm_address1=45_Pine_St&utm_propertyaddress=45_Pine_St>

When Sarah scans her QR code, you’ll know:

* She came from the “postcard” campaign
* It was part of your “teeth\_whitening” campaign
* And you can match her visit to her mailing record in your dashboard

{% hint style="info" %}
UTMs = Easier tracking, clearer insights, and smarter marketing decisions.
{% endhint %}

**Support & Contact**

If you run into issues, have questions, or want help with setup, we’re here for you.

For direct support, please visit our support guide: [How to Reach Support](https://help.openletterconnect.com/olc-help-docs/contact-us/how-to-reach-support)
