Skip to content
PynPyn

Settings

Create a conditional recipient

One step in your onboarding flow goes to the local People partner, but who that is depends on the employee’s region. A conditional recipient does that with ordered rules and a fallback, and you pick it in To on a step like any other recipient.

The Create Conditional Recipient dialog with Name, Medium, Fallback recipient and a first rule.
The Create Conditional Recipient dialog with a medium, a fallback recipient and one rule.
  1. In Pyn, open Settings in the left navigation, then Conditional Recipients under General.

  2. Select Add. The Create Conditional Recipient dialog opens.

  3. Enter a Name and choose the Medium: Email, Slack or Teams. The medium cannot be changed once the conditional recipient exists, and only steps on that medium offer it.

  4. Choose the Fallback recipient. It receives the step when no rule matches and is required.

  5. Open Rule 1. Set its audience (Lifecycle, Included, Excluded) and choose Send to: Employee, Buddy, HRBP, Manager or Skip-level Manager, or on an email medium Employee (Personal) or a custom email recipient. The Audience Preview underneath shows who the rule covers.

  6. Select Add rule for each further case, up to 20. Use the arrow and X buttons beside a rule (Move rule up, Move rule down, Remove rule) to order them; the first matching rule wins, and the last remaining rule cannot be removed.

  7. Select Save. The button stays disabled until the name, the fallback and every rule’s recipient and lifecycle are set.

  8. Open a step in an automation, select To or a Cc row, and choose the conditional recipient under Conditional Recipients.

  • When the step runs, Pyn checks the rules top to bottom against the enrolled employee and sends to the first match’s Send to recipient. The Fallback recipient receives it when no rule matches.
  • A rule’s audience works like a step audience: lifecycle stages plus included and excluded groups. Every rule needs at least one lifecycle stage. See How audiences match.
  • Rules are read when the step sends, so editing a conditional recipient changes every step that uses it.
  • A conditional recipient has up to 20 rules and one medium, and a rule cannot point to another conditional recipient.

The new row lists the Name, Medium and number of Rules; select it to edit, or archive it from its … menu. On a step of the same medium, To and each Cc row list it under Conditional Recipients, and on a Post to Channel step it follows the channels in To. Once an employee is enrolled, their step under Enrollments names the person the rules chose. If saving fails the dialog shows “Could not save conditional recipient” or the reason, for example “Every rule needs at least one lifecycle stage”.