Skip to content
Nappai Documentation

Outlook Calendar Webhook

Outlook Calendar Webhook starts a flow every time something changes in your Outlook calendar: when an event is created, when an existing one is updated or when one is cancelled or deleted.

NappAI checks your calendar every short while and, if it finds changes, runs the flow with the details of each affected event. You don’t need to set anything up in Microsoft: the credential and a subscription for the flow are enough.

When to use it

  • You want to send a reminder or an agenda to attendees every time a new meeting is scheduled.
  • When an appointment is cancelled, you want to free the slot in another tool or let the client know.
  • You want to keep your Outlook calendar in sync with a CRM or a spreadsheet.
  • An AI agent should prepare a brief for every meeting added to your calendar.

Configuration

You need a Microsoft Outlook credential, which connects by signing in with your Microsoft account. See Credentials.

FieldWhat it does
Credential (required)The Microsoft Outlook credential of the account whose main calendar you want to watch.
EventsThe changes that start the flow: Event Created (an event is created), Event Updated (an event is modified) and Event Deleted (an event is cancelled or removed). By default, all three. If you choose none, all three are used.
DataTest field. It lets you try the flow with a sample event without waiting for a real change in the calendar. Leave it empty in normal use.

Turning on the subscription

The flow only receives changes while it is subscribed:

  1. Save the flow and publish a version. A published version of the flow is required to subscribe. See Versions and publishing.
  2. In the node’s settings panel, click Subscribe.
  3. In the panel that opens, click Subscribe. The status changes to Synced.

If you later change the events, the status shows Out of sync: subscribe again to apply the changes. From the same panel you can Unsubscribe.

Output

The Data output contains one item for each event that changed, with the type of change (created, updated or deleted), the event identifier, the subject, the start and end date and time, the status and the organizer. If several changes arrive at once, they all come out together.

Connect it to Calendar to look up the full event, to an AI agent, or to an email or messaging component.

Example

A consultancy wants to send each client a confirmation email when a meeting is scheduled with them.

  1. Add Outlook Calendar Webhook and choose the consultancy’s Microsoft Outlook credential.
  2. In Events, keep only Event Created.
  3. Connect the Data output to an agent that writes the confirmation with the meeting’s subject and time, and then to Email with the Send Message operation.
  4. Publish the flow and click Subscribe.

Good practices

  • Choose only the events you need. If the flow modifies events in the same calendar and you listen to Event Updated, it will run again with its own changes.