Send a message
Send a message to a participant or another researcher.
By default the message goes into the current conversation between you and the recipient, which is created if it doesn’t exist yet. Pass conversation_id to send into a specific conversation instead. The recipient must be a member of it, otherwise the request is rejected with a 400, and a conversation you are not a member of is reported as not found.
A message that names a study_id or a category also sets the study and topic on the conversation it lands in. For participant senders, the study is set on the conversation only if the participant has a submission for that study and the recipient is the study’s researcher, publisher or workspace. Otherwise the message is still sent, and the conversation’s study is left unchanged.
Authentication
The Prolific API uses API token to authenticate requests. You can create an API token directly from your settings.
Your API token does not have an expiry date and carries full permission, so be sure to keep them secure.
If your token is leaked, delete it and create a new one directly in the app.
In your requests add Authorization header with the value Token <your token>.
Request
Send into this conversation rather than the default one between you and the recipient. Get ids from GET /api/v1/conversations. The recipient must be a member.