Создать правило автоответа или пересылки

Метод позволяет создать правило автоответа или пересылки писем для сотрудника. Возможность пересылки есть только на домены, которые принадлежат выбранной организации. Подтверждение получения пересылки при создании такого правила не требуется.

Примечание

Чтобы выполнить запрос, приложению требуется разрешение на управление настройками почты пользователя. Убедитесь, что вы включили его при настройке приложения на OAuth-сервере Яндекса.

Request

POST

https://api360.yandex.net/admin/v1/org/{orgId}/mail/users/{userId}/settings/user_rules

Path parameters

Name

Description

orgId*

Type: integer<int64>

Идентификатор организации.

userId*

Type: string<uint64>

Идентификатор пользователя.

Body

application/json
{
    "autoreply": {
        "ruleName": "string",
        "text": "string"
    },
    "forward": {
        "ruleName": "string",
        "address": "string",
        "withStore": false
    }
}

Name

Description

autoreply

Type: v1CreateUserAutoreplyRule

forward

Type: v1CreateUserForwardRule

v1CreateUserAutoreplyRule

Name

Description

ruleName

Type: string

Название правила.

text

Type: string

Текст автоответа.

v1CreateUserForwardRule

Name

Description

address

Type: string

Email получателя пересылаемого письма.

ruleName

Type: string

Название правила.

withStore

Type: boolean

Признак того, нужно ли сохранять копию письма в ящике исходного получателя.

Responses

200 OK

Запрос успешно выполнен.

Body

application/json
{
    "ruleId": 0
}

Name

Description

ruleId

Type: integer<int64>

Идентификатор правила.

401 Unauthorized

Пользователь не авторизован.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

403 Forbidden

У пользователя или приложения нет прав на доступ к ресурсу, запрос отклонен.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

404 Not Found

Запрашиваемый ресурс не найден.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.

500 Internal Server Error

Внутренняя ошибка сервиса. Попробуйте повторно отправить запрос через некоторое время.

Body

application/json
{
    "code": 0,
    "message": "string",
    "details": [
        null
    ]
}

Name

Description

code

Type: integer<int32>

Код ошибки.

details

Type: any[]

Дополнительные сведения об ошибке.

message

Type: string

Описание ошибки.