Creating a staged user with an API call

[blake (Blake Erickson)]

The only parameter this endpoint takes is a valid email message:

curl -i -sS -X POST "http://localhost:3000/admin/email/handle_mail" \
-H "Api-Key: 852b2d8556777aeb62346e0d8b36ed248a89b03f0261165a685c0aae9c8c2fdd" \
-H "Api-Username: system" \
-F "email=Date: Mon, 24 Feb 2020 13:13:34 -0700
From: stageduser2@example.com
To: awesome@example.com
Subject: test email5

This is a sample email message.
"

You will need to make sure you enable email_in correctly setup your category or group to receive these emails:

Start a New Topic via Email

If you have already set up reply via email, or you are on a hosting plan that pre-configures your incoming email, you’re now ready to set up Starting a New Topic via Email. Site Settings The incoming emails feature is globally controlled by these 3 site settings: email_in: this is the only setting that must be enabled for incoming emails to work. email_in_min_trust: the minimum trust level required for users to send an email to Discourse. enable_staged_users: create staged users for unkn…

@dm.linov

Also, did I get it right, that such a user will receive notifications for new posts in such a topic and will be able to reply to it via email?

Yes, I believe so.

@dm.linov

And what happens, if I try to create a staged user and a topic via an API call with an email address that belongs to an active user? Will this topic be created on behalf of such user?

Yes, the topic will be created on behalf of the user.