If you need a recurring Outlook calendar event that ends on a specific date, the part people usually miss is this: in Microsoft Graph, recurrence is split into two objects:

• recurrence.pattern = how it repeats
• recurrence.range = how long it keeps repeating

If you want the series to stop on a date, the key is:

"range": {
  "type": "endDate",
  "startDate": "2026-08-17",
  "endDate": "2026-12-31"
}

That endDate does not replace the event’s normal start and end times. It only tells Outlook when the recurring series should stop.

Microsoft’s docs for recurring events are here:

• Schedule repeating appointments as recurring events in Outlook
• recurrencePattern resource
• recurrenceRange resource

The shape you actually need

A recurring Outlook event with an end date has three layers:

1. The normal event fields: subject, start, end, location, attendees, etc.
2. recurrence.pattern: daily, weekly, monthly, yearly
3. recurrence.range: no end, fixed number of occurrences, or specific end date

Here’s the smallest useful example.

Example: weekly recurring Outlook event with an end date

{
  "subject": "Weekly Team Sync",
  "start": {
    "dateTime": "2026-08-17T09:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "end": {
    "dateTime": "2026-08-17T09:30:00",
    "timeZone": "Eastern Standard Time"
  },
  "recurrence": {
    "pattern": {
      "type": "weekly",
      "interval": 1,
      "daysOfWeek": ["Monday"]
    },
    "range": {
      "type": "endDate",
      "startDate": "2026-08-17",
      "endDate": "2026-12-31"
    }
  }
}

That creates a Monday series starting August 17, 2026 and ending on December 31, 2026.

What each field means

pattern.type

Common values:

• daily
• weekly
• absoluteMonthly
• relativeMonthly
• absoluteYearly
• relativeYearly

pattern.interval

How often it repeats.

Examples:

• 1 = every week
• 2 = every other week
• 1 with absoluteMonthly = every month

pattern.daysOfWeek

Used for weekly and relative patterns.

Example:

"daysOfWeek": ["Monday", "Thursday"]

range.type

This is where the end condition lives.

Options:

• noEnd
• numbered
• endDate

If you need the recurrence to stop on a calendar date, use endDate.

range.startDate

This is required for recurring series. In practice, it should match the date portion of the event’s first start.dateTime.

range.endDate

The date the recurring series stops. Outlook uses this as the end boundary for valid occurrences.

Example: recurring event on Monday and Thursday until a date

{
  "subject": "Office Hours",
  "start": {
    "dateTime": "2026-08-17T15:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "end": {
    "dateTime": "2026-08-17T16:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "recurrence": {
    "pattern": {
      "type": "weekly",
      "interval": 1,
      "daysOfWeek": ["Monday", "Thursday"]
    },
    "range": {
      "type": "endDate",
      "startDate": "2026-08-17",
      "endDate": "2027-01-31"
    }
  }
}

Example: monthly recurring event with an end date

If you want “the 15th of every month until December 31,” use absoluteMonthly.

{
  "subject": "Monthly Billing Review",
  "start": {
    "dateTime": "2026-08-15T11:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "end": {
    "dateTime": "2026-08-15T12:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "recurrence": {
    "pattern": {
      "type": "absoluteMonthly",
      "interval": 1,
      "dayOfMonth": 15
    },
    "range": {
      "type": "endDate",
      "startDate": "2026-08-15",
      "endDate": "2026-12-31"
    }
  }
}

POST request example

To create the event in Microsoft Graph:

POST https://graph.microsoft.com/v1.0/me/events
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

With JavaScript:

const event = {
  subject: 'Weekly Team Sync',
  start: {
    dateTime: '2026-08-17T09:00:00',
    timeZone: 'Eastern Standard Time'
  },
  end: {
    dateTime: '2026-08-17T09:30:00',
    timeZone: 'Eastern Standard Time'
  },
  recurrence: {
    pattern: {
      type: 'weekly',
      interval: 1,
      daysOfWeek: ['Monday']
    },
    range: {
      type: 'endDate',
      startDate: '2026-08-17',
      endDate: '2026-12-31'
    }
  }
};

await fetch('https://graph.microsoft.com/v1.0/me/events', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${accessToken}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify(event)
});

The 4 mistakes that usually break this

1. Putting the end date in the wrong place

The series end date belongs in:

recurrence.range.endDate

Not in the event end.dateTime.

2. Forgetting range.startDate

Even if you already have start.dateTime, the recurrence range still needs its own startDate.

3. Mismatching start.dateTime and range.startDate

If the first event starts on 2026-08-17, your recurrence range should also start on 2026-08-17.

4. Mixing pattern fields across recurrence types

Examples:

• dayOfMonth belongs with absoluteMonthly
• daysOfWeek belongs with weekly or relative patterns
• index is used for relative patterns like “first Monday”

If you want a fixed number of occurrences instead

Use numbered instead of endDate:

"range": {
  "type": "numbered",
  "startDate": "2026-08-17",
  "numberOfOccurrences": 10
}

If you want it to never end

Use:

"range": {
  "type": "noEnd",
  "startDate": "2026-08-17"
}

Outlook recurring events are more annoying than Google Calendar

That’s the whole reason this trips people up. In Google Calendar, many developers are used to dropping an RRULE into one field. In Outlook via Microsoft Graph, recurrence is more structured:

• pattern
• range
• plus the normal event time block

Once you know that split, it’s straightforward.

Final copy-paste template

{
  "subject": "Your event title",
  "start": {
    "dateTime": "2026-08-17T09:00:00",
    "timeZone": "Eastern Standard Time"
  },
  "end": {
    "dateTime": "2026-08-17T09:30:00",
    "timeZone": "Eastern Standard Time"
  },
  "recurrence": {
    "pattern": {
      "type": "weekly",
      "interval": 1,
      "daysOfWeek": ["Monday"]
    },
    "range": {
      "type": "endDate",
      "startDate": "2026-08-17",
      "endDate": "2026-12-31"
    }
  }
}

If you want an assistant that can do this kind of calendar work without you wiring Graph payloads by hand, Carly integrates with Outlook and can manage recurring calendar workflows across email, scheduling, tasks, and automation.

Related Articles

Guides

Best AI Email Triage Tools in 2026: 10 Ranked

Aug 18, 2026

Guides

Claude Cowork Connectors: What Actually Connects in 2026

Aug 18, 2026

Guides

Claude Cowork and Google Sheets: Read Yes, Edit No

Aug 18, 2026