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:

Configure incoming email to create new topics or group messages

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 allowed groups: a user must belong to this group in order to send an email to Discourse. enable_staged_users: create staged users for u…

@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.