CIPP Advanced icon

CIPP Advanced

Advanced Microsoft 365 multi-tenant management via CIPP.app (465 operations, 29 resources)

Actions467

Transport → Add or Edit Rule

AI-generated

Summary

Create or update a tenant’s Exchange transport rule, setting its name and enabled state and optionally defining matching conditions, message actions, activation date, comments, or additional API properties.

Inputs

  • Tenant (required) — Select a tenant from the list or enter its domain.
  • Rule Name (required) — Name of the transport rule to create or edit.
  • Enabled — Whether the rule is enabled; defaults to true.
  • Conditions — Optional match criteria such as sender, recipient, message size, subject or body words, attachment words, sender IP ranges, and spam confidence level. Comma-separated values are accepted for the corresponding word, domain, and IP range fields.
  • Actions — Optional message handling settings: apply Office Message Encryption, blind copy or copy to a recipient, delete the message, apply an HTML disclaimer with fallback and placement options, or set message importance.
  • Additional Fields — Optionally set an activation date or comments, or provide Extra Properties as a JSON object merged into the request body.
  • Normalize Numeric Strings — Whether to convert numeric-looking string values in returned data to numbers; defaults to false.

Output shape

A single API response item for the created or updated transport rule.

The source pack identifies this as a tenant-scoped write operation and merges the condition, action, additional field, and extra JSON values into the request body. The response fields are determined by the CIPP API.

Links

Discussion