*** DEPRECATED, USE: https://gist.github.com/lfepp/16a670d7a5e21afa5302401c2fe91653

pd_maintenance_windows.rb

#!/usr/bin/env ruby

# Ruby script to create recurring maintenance windows in PagerDuty
# 
# Copyright (c) 2012, PagerDuty, Inc. <info@pagerduty.com>
# All rights reserved.
# 
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#     * Redistributions of source code must retain the above copyright
#       notice, this list of conditions and the following disclaimer.
#     * Redistributions in binary form must reproduce the above copyright
#       notice, this list of conditions and the following disclaimer in the
#       documentation and/or other materials provided with the distribution.
#     * Neither the name of PagerDuty Inc nor the
#       names of its contributors may be used to endorse or promote products
#       derived from this software without specific prior written permission.
# 
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
# DISCLAIMED. IN NO EVENT SHALL PAGERDUTY INC BE LIABLE FOR ANY
# DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
# LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
# ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
# SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
# Tested with Ruby 1.9.3
# Requires rubygems (Ruby 1.9.3 comes with Rubygems)
# Just run the following from a terminal to install the necessary gems
# 
# sudo gem install json
# sudo gem install faraday
# sudo gem install active_support
# 


require 'rubygems'
require 'active_support/core_ext'
require 'faraday'
require 'json'

DATE_FORMAT =  "%FT%T:%z"

class PagerDutyAgent

  def initialize(options = {})
    @options = options
    @connection = Faraday.new(:url => "https://#{options[:subdomain]}.pagerduty.com", 
                              :ssl => {:verify => false}) do |c|
      c.request  :url_encoded
      c.response :logger
      c.adapter  :net_http
    end
  end

  # E.g. post("/api/v1/maintenance_windows", )
  def post(url, body = {}, headers = {})
    @connection.post do |req|
      req.url(url)
      req.headers['Content-Type'] = 'application/json'
      req.headers['Authorization'] = "Token token=#{@options[:token]}"
      puts JSON.generate(body)
      req.body = JSON.generate(body)
    end
  end

end

pd = PagerDutyAgent.new(:subdomain => "SUBDOMAIN", :token => "YOUR-API-TOKEN")

# User id (the user that is putting the service in maintenance mode)
requester_id = "YOUR-USER-ID"
# List of services that are part of this maintenance
service_ids = ["P1007W0"]

maintenance_start_time = Time.utc(2012, 11, 17, 12, 30).localtime("-08:00")
maintenance_end_time = maintenance_start_time + 2.hours

# Recur this maintenance window for the next 20 weeks

20.times do

  pd.post("/api/v1/maintenance_windows", 
  { "maintenance_window" => {
      "start_time" => maintenance_start_time.strftime(DATE_FORMAT),
      "end_time" => maintenance_end_time.strftime(DATE_FORMAT),
      "description" => "Weekly maintenance",
      "service_ids" => service_ids
    },
    "requester_id" => requester_id
  })
  maintenance_start_time = maintenance_start_time + 1.week
  maintenance_end_time = maintenance_start_time + 2.hours
end

This is a required feature for this type of service.

Requiring a paying customer to use an API to setup a basic feature like this is like requiring a smartphone to operate your microwave.

@jpierson83301 I think there is also UI for this. Personally I find this useful for programmatically creating a maintenance window--that said where is the documentation for the API? I didn't see it in the blog post that got me here either.