# Send a message for an event

POST https://api.moveworks.ai/rest/v1/events/{event_id}/messages/send
Content-Type: application/json

Send a message to a list of recipients for an event. The event must be defined in the Events Workspace.


Reference: https://docs.moveworks.com/api-reference/events-api/events/send-message-for-event

## OpenAPI Specification

```yaml
openapi: 3.1.1
info:
  title: Send a message for an event
  version: endpoint_events.sendMessageForEvent
paths:
  /rest/v1/events/{event_id}/messages/send:
    post:
      operationId: send-message-for-event
      summary: Send a message for an event
      description: >
        Send a message to a list of recipients for an event. The event must be
        defined in the Events Workspace.
      tags:
        - - subpackage_events
      parameters:
        - name: event_id
          in: path
          description: ID of the event to notify for
          required: true
          schema:
            type: string
            format: uuid
        - name: Authorization
          in: header
          description: >-
            Bearer authentication of the form `Bearer <token>`, where token is
            your auth token.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully scheduled
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageScheduled'
        '400':
          description: Bad Request
          content: {}
        '401':
          description: Unauthenticated
          content: {}
        '403':
          description: Unauthorized
          content: {}
        '404':
          description: Event not found
          content: {}
        '429':
          description: Rate Limit Exceeded
          content: {}
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendMessageForEventRequest'
components:
  schemas:
    SendMessageForEventRequestContextSlots:
      type: object
      properties: {}
    SendMessageForEventRequestContext:
      type: object
      properties:
        slots:
          $ref: '#/components/schemas/SendMessageForEventRequestContextSlots'
          description: Contextual slots
    SendMessageForEventRequest:
      type: object
      properties:
        message:
          type: string
          description: >-
            Message to be sent, formatted in Moveworks' version of HTML.
            Moveworks attempts to shorten valid links to fit within chat
            platform constraints. Consult your chat platform API documentation
            to understand actual character limits.
        recipients:
          type: array
          items:
            type: string
          description: Email addresses of the employees to send the message to
        context:
          $ref: '#/components/schemas/SendMessageForEventRequestContext'
          description: Additional contextual data
      required:
        - message
        - recipients
    MessageScheduledDataStatus:
      type: string
      enum:
        - value: RECEIVED
    MessageScheduledData:
      type: object
      properties:
        status:
          $ref: '#/components/schemas/MessageScheduledDataStatus'
    MessageScheduled:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MessageScheduledData'

```

## SDK Code Examples

```python
import requests

url = "https://api.moveworks.ai/rest/v1/events/event_id/messages/send"

payload = {
    "message": "This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\"https://moveworks.com\">Links</a></li><li>and just about <a href=\"https://www.webfx.com/tools/emoji-cheat-sheet/\"> any emoji you want </a>:fire:</li></ul>",
    "recipients": ["email@email.com"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())
```

```javascript
const url = 'https://api.moveworks.ai/rest/v1/events/event_id/messages/send';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"message":"This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\"https://moveworks.com\">Links</a></li><li>and just about <a href=\"https://www.webfx.com/tools/emoji-cheat-sheet/\"> any emoji you want </a>:fire:</li></ul>","recipients":["email@email.com"]}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.moveworks.ai/rest/v1/events/event_id/messages/send"

	payload := strings.NewReader("{\n  \"message\": \"This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\\\"https://moveworks.com\\\">Links</a></li><li>and just about <a href=\\\"https://www.webfx.com/tools/emoji-cheat-sheet/\\\"> any emoji you want </a>:fire:</li></ul>\",\n  \"recipients\": [\n    \"email@email.com\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby
require 'uri'
require 'net/http'

url = URI("https://api.moveworks.ai/rest/v1/events/event_id/messages/send")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"message\": \"This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\\\"https://moveworks.com\\\">Links</a></li><li>and just about <a href=\\\"https://www.webfx.com/tools/emoji-cheat-sheet/\\\"> any emoji you want </a>:fire:</li></ul>\",\n  \"recipients\": [\n    \"email@email.com\"\n  ]\n}"

response = http.request(request)
puts response.read_body
```

```java
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.post("https://api.moveworks.ai/rest/v1/events/event_id/messages/send")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"message\": \"This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\\\"https://moveworks.com\\\">Links</a></li><li>and just about <a href=\\\"https://www.webfx.com/tools/emoji-cheat-sheet/\\\"> any emoji you want </a>:fire:</li></ul>\",\n  \"recipients\": [\n    \"email@email.com\"\n  ]\n}")
  .asString();
```

```php
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.moveworks.ai/rest/v1/events/event_id/messages/send', [
  'body' => '{
  "message": "This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\\"https://moveworks.com\\">Links</a></li><li>and just about <a href=\\"https://www.webfx.com/tools/emoji-cheat-sheet/\\"> any emoji you want </a>:fire:</li></ul>",
  "recipients": [
    "email@email.com"
  ]
}',
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Content-Type' => 'application/json',
  ],
]);

echo $response->getBody();
```

```csharp
using RestSharp;

var client = new RestClient("https://api.moveworks.ai/rest/v1/events/event_id/messages/send");
var request = new RestRequest(Method.POST);
request.AddHeader("Authorization", "Bearer <token>");
request.AddHeader("Content-Type", "application/json");
request.AddParameter("application/json", "{\n  \"message\": \"This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\\\"https://moveworks.com\\\">Links</a></li><li>and just about <a href=\\\"https://www.webfx.com/tools/emoji-cheat-sheet/\\\"> any emoji you want </a>:fire:</li></ul>\",\n  \"recipients\": [\n    \"email@email.com\"\n  ]\n}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
```

```swift
import Foundation

let headers = [
  "Authorization": "Bearer <token>",
  "Content-Type": "application/json"
]
let parameters = [
  "message": "This is a rich message that supports <b>bold</b> and <i>italics</i>.<br><br> Did I mention, we also support:<br><ul><li>Lists</li><li><a href=\"https://moveworks.com\">Links</a></li><li>and just about <a href=\"https://www.webfx.com/tools/emoji-cheat-sheet/\"> any emoji you want </a>:fire:</li></ul>",
  "recipients": ["email@email.com"]
] as [String : Any]

let postData = JSONSerialization.data(withJSONObject: parameters, options: [])

let request = NSMutableURLRequest(url: NSURL(string: "https://api.moveworks.ai/rest/v1/events/event_id/messages/send")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "POST"
request.allHTTPHeaderFields = headers
request.httpBody = postData as Data

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```