The Open API specification for Synapse is now available for download!

Download Open API Spec

POST /message

Sends a message.

The "fileHandleId" field should point to a plain text file containing the body of the message. The file should be uploaded prior to this call.

The "recipients" field should hold a set of IDs corresponding to the recipients of the message.

All other fields are optional, including the "subject" field. To chain messages together into a conversation, specify the message you are replying to via the "inReplyTo" field.

See the message schema, message content schema, and message recipient schema for more information.

In most cases, message delivery is asynchronous to message creation. i.e. It may take several seconds for a message to appear in a user's inbox.

Notes:
Unauthorized delivery, such as messaging a team you are not affiliated with, will result in a bounce message being sent to your email.
There are limits on the number of message recipients you can specify (50) and the rate at which you can send messages (10 per minute). Neither these restrictions, nor the restriction that you can't message a Team with which you are unaffiliated, apply if you are a member of the Trusted Message Senders Team.

Resource URL

https://repo-prod.prod.sagebase.org/repo/v1/message

Resource Information
Authentication Required
Required OAuth Scopes view , modify
HTTP Method POST
Request Object MessageToUser
(application/json)
Response Object MessageToUser
(application/json)