---
title: "Create notification rule step"
method: POST
path: "/api/{cloudId}/v1/notification-rules/{ruleId}/steps"
tags: ["Notification rule steps"]
---

# Create notification rule step

`POST /api/{cloudId}/v1/notification-rules/{ruleId}/steps`

Creates a notification rule step with the given properties.

## Path parameters

- `ruleId` string, required

## Request body

- NotificationRulesStepCreateNotificationRuleStepRequest
  - `contact` NotificationRulesStepContact, required — Defines the contact that notification will be sent to.
    - `method` 'email' | 'sms' | 'voice' | 'mobile', required — This parameter is the contact method of user.
    - `to` string, required — Address of the contact notification will be sent to.
  - `sendAfter` integer — Time period when notification will be sent after in minutes.
  - `enabled` boolean, required — Specifies whether given step will be enabled or not when it is created.

## Response `201`

Returned if the request is successful.

- NotificationRulesStepNotificationRuleStep
  - `id` string — Identifier of the notification rule step which belongs to given notification rule.
  - `sendAfter` integer — Time period when notification will be sent after in minutes.
  - `contact` NotificationRulesStepContact — Defines the contact that notification will be sent to.
    - `method` 'email' | 'sms' | 'voice' | 'mobile', required — This parameter is the contact method of user.
    - `to` string, required — Address of the contact notification will be sent to.
  - `enabled` boolean — Specifies whether given step will be enabled or not when it is created.

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `403` — Returned if the request user does not have permission to create notification rule step.
- `404` — Returned if the notification rule with given id is not found.

---

[API](https://skmtc.net/atlassian/apis/jsm-operations-api.md) · [All operations](https://skmtc.net/atlassian/apis/jsm-operations-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/atlassian/jsm-operations-api/versions/ed65f017bcb8/schema)