---
title: "Create forwarding rule"
method: POST
path: "/api/{cloudId}/v1/forwarding-rules"
tags: ["Forwarding rules"]
---

# Create forwarding rule

`POST /api/{cloudId}/v1/forwarding-rules`

Creates a forwarding rule with the given properties.

## Request body

- CreateForwardingRuleRequest
  - `toUserId` string, required — The id of user who will receive the forwarded notifications.
  - `fromUserId` string, required — The id of user whose notifications will be forwarded.
  - `startDate` string, date-time, required — The date and time for forwarding will start, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).
  - `endDate` string, date-time, required — The date and time for forwarding will end, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).

## Response `201`

Returned if the request is successful.

- ForwardingRuleResponse
  - `id` string — Identifier of the forwarding rule.
  - `fromUserId` string — The id of user whose notifications will be forwarded.
  - `toUserId` string — The id of user who will receive the forwarded notifications.
  - `startDate` string — The date and time for forwarding will start, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).
  - `endDate` string — The date and time for forwarding will end, which takes a date format as (yyyy-MM-dd'T'HH:mm:ssZ) (e.g. 2017-01-15T08:00:00+02:00).

## Other responses

- `401` — Returned if the authentication credentials are incorrect.
- `402` — Returned if the customer subscription plan does not cover forwarding rule.
- `403` — Returned if the request user does not have permission to create forwarding rule.
- `404` — Returned if user with the given Id does not found.
- `422` — Returned if the payload cannot be validated.

---

[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)