Webhooks
Every company has its own processes. With webhooks, Seamless reports events to your systems, for example to an Azure Logic App, Power Automate or a ticketing system. There you decide what happens: create a ticket, send an email or update data in another system.
How it works
- You enter the address of your system in a template.
- When the event occurs, Seamless sends a notification to this address.
- Your system processes the notification and responds with
200.
If the notification does not arrive, Seamless tries again. You can see the delivery under Monitoring > Webhooks.
Where to set up webhooks
| Event | Where |
|---|---|
| New request for a team | Teams & Sites template > Approval |
| Team needs to be reviewed | Teams & Sites template > Lifecycle |
| Team archived | Teams & Sites template > Archiving |
| New invitation for a guest | Guest template > Approval |
| Invitation pending, guest inactive, blocked, deleted or due for review | Guest template > Lifecycle |
The fields
| Field | Description |
|---|---|
| Notification endpoint | Address to which Seamless sends the notification |
| Secret | Optional: a secret that Seamless sends in the header. This lets your system check that the notification comes from Seamless. |
The events
| Event | When |
|---|---|
team.report.renewal | A team needs to be reviewed |
team.archive | A team was archived |
user.invite | A guest is invited |
user.report.invitationAcceptance | A guest has not accepted the invitation |
user.delete.invitationAcceptance | A guest with a pending invitation was deleted |
user.report.inactivity | A guest is inactive |
user.block.inactivity | An inactive guest was blocked |
user.delete.inactivity | An inactive guest was deleted |
user.report.renewal | A guest needs to be reviewed |
The notification
Seamless sends the notification as JSON with the event and the ID of the affected guest or team:
{
"payload": {
"userId": "f7a718c5-3c74-4ae3-874e-5d1db9..."
},
"eventType": "user.report.inactivity"
}You can find a complete example with an Azure Logic App under Example: Inactive guest.