Integrate with Outlook

Send information and email invitations to event participants directly from your workflow.

Before you begin

Prepare to connect to Microsoft

As part of the integration, you need to whitelist the Next Matter domain and create a service account. See if you've completed all the required steps.

  • Understand how data references work. See Use data references. This will help you use the captured data in the workflow steps.

🚧

Good to know: Check out our ready-made templates available when you add a step and select Templates > 3rd party templates. You can use the templates to create a set of pre-configured steps.
Need a specific template? Click the Contact us button in the top right of the page and let us know.

I want to send an email code-free
Use a Next Matter no-code step. You can select it in **Integrations**. For details, see [Outlook no-code](https://help.nextmatter.com/docs/connect-to-microsoft-outlook-code-free)
I want to use an advanced integration: email invite

Send an email invite

  1. In your Next Matter portal, click Workflows, and then click the workflow that should send invites to Outlook.
  2. Click Edit workflow.
  3. Click +Add step and select Integration > Custom integration.
  4. Click Settings to configure the step.
  5. Enter the following details:
    • Method: POST
    • URL: https://graph.microsoft.com/v1.0/users/YOUR_USER_ID/calendar/events
      Your user ID is the unique email address that was created for you to use when you sign in to Microsoft 365. A user ID may look similar to the following: [email protected].
    • Headers: Content-Type: application/json
    • In the Body enter the values. For example, the body might look like the following.
      {
        "subject": "EMAIL_SUBJECT", //this is a placeholder
        "body": {
          "contentType": "HTML",
          "content": "EMAIL_CONTENT" //this is a placeholder
        },
        "start": {
            "dateTime": "START_DATE_YYYY-MM-DD & START_TIME_HH:MM:SS", //this is a placeholder
            "timeZone": "TIMEZONE" //this is a placeholder
        },
        "end": {
            "dateTime": "END_DATE_YYYY-MM-DD & END_TIME_HH:MM:SS", //this is a placeholder
            "timeZone": "TIMEZONE" //this is a placeholder
        },
        "location":{
            "displayName":"LOCATION_NAME" //this is a placeholder; it can be  event location or a meeting link for a virtual meeting
        },
        "attendees": [ //you cabn have multiple attendees
          {
            "emailAddress": {
              "address":"ATTENDEE_1_Email_Address", //this is a placeholder
              "name": "ATTENDEE_1_Name" //this is a placeholder
            },
            "type": "Required / Optional" //select one
          },
      {
            "emailAddress": {
              "address":"ATTENDEE_2_Email_Address", //this is a placeholder
              "name": "ATTENDEE_2_Name" //this is a placeholder
            },
            "type": "Required / Optional" //select one
          },
        ]
      }
      
  6. Save your changes.