How to send messages with the python client

You can send messages through OpenReview using the python client post_message function. You will first need to install and setup the python client. Your recipients could be a list of OpenReview profile IDs, a list of email addresses, or an OpenReview group ID. The important thing is that whichever ID you use for the recipient, it has to be a member of a group you are a writer of. This property is called the parentGroup. This is how OpenReview gives permission to organizers to send emails. If you do not know what the corresponding group of your recipient is, you can find it with the following query:

https://api2.openreview.net/groups?members=<email or profile ID>&details=writable&select=id,details.writable

This will return a JSON with the property id and details.writable. If a group has details.writable=true, that group id can be used as your parentGroup.

If addressing the recipients in the 'message', please use the preferred name listed in the user's profile.

To send a message to all of your venue's authors, or example:

subject = 'Your message subject'
message = 'Hello, please go to your submission and do x, y, and z.'
recipients = ['Your/Conference/ID/Authors']
parentGroup = f'Your/Conference/ID/Submission{submission_number}/Authors'
client.post_message(subject, recipients, message, parentGroup=parentGroup)

If you wanted to include a link to each author's paper in the email, you could instead iterate through each submission and send an email with the papers' authorids fields as recipients:

submissions = client.get_all_notes(invitation = 'Your/Conference/Id/-/Submission')
for submission in submissions: 
    subject = f'Message regarding Paper #{submission.number}'
    message = f'Hello, please go to your submission and do x, y, z. Find your submission here: https://openreview.net/forum?id={submission.forum}'
    recipients = submission.content['authorids']
    parentGroup = f'Your/Conference/ID/Submission{submission.number}/Authors'
    client.post_message(subject, recipients, message, parentGroup=parentGroup)

If you want to email a subset of reviewers in the Reviewers group, you can send messages to recipients listed in an array.

subject = 'Your message subject'
message = 'Hello, please go to your review and do x, y, and z.'
recipients = ['[e-mail]','[e-mail]','[e-mail]']
parentGroup = f'Your/Conference/ID/Reviewers'
client.post_message(subject, recipients, message, parentGroup=parentGroup)