message: send
11/16/2021
2 minutes to read
Is this page helpful?
In this article
Namespace: microsoft.graph
Send an existing draft message.
The draft message can be a new message draft , reply draft , reply-all draft , or a forward draft .
This method saves the message in the Sent Items folder.
Alternatively, send a new message in a single operation.
Permissions
One of the following permissions are required to call this API. To learn more, including how to choose permissions, see Permissions .
Permission type
Permissions (from least to most privileged)
Delegated (work or school account)
Mail.Send
Delegated (personal Microsoft account)
Mail.Send
Application
Mail.Send
HTTP request
POST /me/messages/{id}/send
POST /users/{id | userPrincipalName}/messages/{id}/send
Name
Type
Description
Authorization
string
Bearer {token}. Required.
Content-Length
number
0. Required.
Request body
Since this method sends an already existing draft message, specifying a request body is not necessary.
Response
If successful, this method returns 202 Accepted response code. It does not return anything in the response body.
Examples
Example 1: Send an existing draft message
The following example shows how to call this API.
Request
Here is an example of the request.
POST https://graph.microsoft.com/v1.0/me/messages/{id}/send
GraphServiceClient graphClient = new GraphServiceClient( authProvider );
await graphClient.Me.Messages["{message-id}"]
.Send()
.Request()
.PostAsync();
Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.
MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];
NSString *MSGraphBaseURL = @"https://graph.microsoft.com/v1.0/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/me/messages/{id}/send"]]];
[urlRequest setHTTPMethod:@"POST"];
MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest
completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {
//Request Completed
}];
[meDataTask execute];
Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.
GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();
graphClient.me().messages("{id}")
.send()
.buildRequest()
.post();
Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.
//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)
messageId := "message-id"
graphClient.Me().MessagesById(&messageId).Send().Post(options)
Read the SDK documentation for details on how to add the SDK to your project and create an authProvider instance.
Response
Here is an example of the response.
HTTP/1.1 202 Accepted
