Skip to main content
POST
/
v2
/
schedules
/
{schedule_id}
/
sync_rules
Create
curl --request POST \
  --url https://api.incident.io/v2/schedules/{schedule_id}/sync_rules \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "schedule_sync_rule": {
    "annotations": {
      "incident.io/terraform/version": "3.0.0"
    },
    "rotation_id": "01JXYZ000000000000000000RT",
    "schedule_sync_target_id": "01JXYZ000000000000000000AB",
    "sync_type": "on_call"
  }
}
'
{
  "schedule_sync_rule": {
    "created_at": "2021-08-17T13:28:57.801578Z",
    "id": "01JXYZ000000000000000000CD",
    "rotation_id": "01JXYZ000000000000000000RT",
    "schedule_id": "01JXYZ000000000000000000EF",
    "schedule_sync_target": {
      "add_bot_to_group": true,
      "created_at": "2021-08-17T13:28:57.801578Z",
      "id": "01JXYZ000000000000000000AB",
      "linked_schedules": [
        {
          "id": "01G0J1EXE7AXZ2C93K61WBPYEH",
          "name": "Primary On-Call Schedule",
          "team_ids": [
            "01JPQA75EPNEES4479P16P4XAB"
          ]
        }
      ],
      "slack_team_id": "T02A1AZHG3J",
      "slack_user_group_id": "S06MNNU5BMK",
      "updated_at": "2021-08-17T13:28:57.801578Z"
    },
    "schedule_sync_target_id": "01JXYZ000000000000000000AB",
    "sync_type": "on_call",
    "updated_at": "2021-08-17T13:28:57.801578Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key from your incident.io dashboard (Settings → API keys)

Path Parameters

​
schedule_id
string
required

The schedule to create a sync rule for

Example:

"01FDAG4SAP5TYPT98WGR2N7W91"

Body

application/json
​
schedule_sync_rule
object
required
Example:
{
  "annotations": { "incident.io/terraform/version": "3.0.0" },
  "rotation_id": "01JXYZ000000000000000000RT",
  "schedule_sync_target_id": "01JXYZ000000000000000000AB",
  "sync_type": "on_call"
}

Response

201 - application/json

Created response.

​
schedule_sync_rule
object
required

A sync rule links a schedule to a sync target, telling us which of the schedule's members should flow into the target's Slack user group.

sync_type decides who is synced: on_call syncs only the people currently on call, while all_users syncs everyone on the schedule. By default every rotation on the schedule is included; set rotation_id to scope the rule to a single rotation. As the schedule's shifts change hands, we keep the target's Slack user group membership in step with the rule.