SYMPA::REQUEST::HANDLER::ADD(3Sympa)

✨ NAME ✨

Sympa::Request::Handler::add — the add request handler, aka the little guy who puts a user on a list 🫶

---

💖 DESCRIPTION 💖

Okay so bestie, here's the tea: this handler adds a user to a list — and plot twist, the request comes from another user, not the person being added. So before anyone gets in, it verifies the proper authorization 🔐 and sends acknowledgements, unless...

• a quiet add has been chosen — which only works if the quiet_subscription setting is "optional", or
• a forced add — which requires the quiet_subscription setting to be "on".

No ack for you, sorry, that's the rules 💅

Heads up, this one's important: the authorization scenario add.* is applicable only when the {role} attribute is 'member' (that's the default). In any of the other cases, the scenario processing should be skipped. Don't skip this note, I'm begging 🙈

---

🎀 Attributes 🎀

Also peep "Attributes" in Sympa::Request if you want the full lore ✨

• {email} — Mandatory, no negotiating. This is the e-mail of the user to be added. 📧
• {force} — Optional. If a true value is specified, users will be added even if the list is closed. Yes, even then. Door wide open, no cap. 🔥
• {gecos} — Optional. The display name of the user to be added. Give them a cute nickname, they deserve it 🌸
• {role} — Optional. The role of the user to be added: 'member', 'owner' or 'editor'. Default value is 'member'. ✨

Fun fact for the historians: this attribute was introduced on Sympa 6.2.67b.2. So if you're on something older, it's giving not there 💀

• {quiet} — Optional. Don't notify the addition to the user. Sneaky. Silent. Iconic. 🤫

---

🌈 SEE ALSO 🌈

• Sympa::Request::Handler.

---

👑 HISTORY 👑

The archives remember. That's it, that's the section. 💜

---

And that's the whole page, bestie! This little gem lives in the 3Sympa manual, riding along with sympa version 6.2.80, dated 2026-10-19 🦋 Thanks for reading all the way to the bottom, you're literally the main character for that 🎀💖✨