An NFC event lets a physical tag scan trigger an action in an outside system. When an employee scans the tag, Connecteam sends a request to a webhook URL you define, so you can connect real-world scans to automation tools or third-party services.
If your goal is to clock an employee in when they scan a tag, you do not need an event. Set up a Time Clock NFC tag instead, which can be tied to a site location and used for clock-in. To learn how, check out the Starting Guide to NFC Clock-in.
Who NFC Events Are For
NFC events suit teams that need a tag scan to reach an external system, such as sending scan data to an automation platform or a custom endpoint. Use an event when the scan must trigger something outside Connecteam. Use a Time Clock tag when the scan only needs to clock the employee in.
How to Create an NFC Event
To create an NFC event, follow these steps:
Go to the NFC settings in your Connecteam dashboard.
Select webhooks and choose the option to add a new NFC event.
Enter a name for the event so you can identify it later.
Enter the webhook URL that Connecteam sends the request to when the tag is scanned.
Enter a secret if you want Connecteam to sign the request, so the receiving system can verify it. This is optional.
Turn on the success popup if you want employees to see a confirmation after a successful scan. This is optional.
Save the event.
The event now appears in your NFC events list with its name and webhook URL.
How to Test an NFC Event
To confirm the event works, follow these steps:
Scan the tag with a device that has the Connecteam app.
Check that the receiving system got the request.
Confirm the success popup appears if you turned it on.
You can edit or remove an event at any time from its options menu.
Frequently Asked Questions
What is the difference between an NFC event and a Time Clock NFC tag?
An NFC event sends a request to an external webhook URL when the tag is scanned. A Time Clock NFC tag clocks the employee in when the tag is scanned and can be tied to a site location, with no external system involved.
Do I need an NFC event to clock an employee in with a tag?
No. To clock an employee in on scan, set up a Time Clock NFC tag. Use an event only when the scan must reach an external system.
Is the secret required?
No. The secret is optional. Add it when the receiving system needs to verify that the request came from Connecteam.
Why is my event not triggering?
Confirm you scanned the correct registered tag, that the webhook URL is a valid address, and that the receiving system is reachable.
Need more guidance? 🙋 Our LIVE support team (at the bottom right corner of your screen) replies to ANY question.