---
sourceDocument: Xanadu API Reference
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu API Reference

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Messaging - Scoped

# Messaging - Scoped {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

The Messaging API provides methods to perform actions in a
third-party messaging application.

This class requires the Messaging Notification plugin (com.glide.notification.messaging) and
an integration with a third-party messaging application such as Slack or Teams. Use these
methods in an action script in the Message Actions \[messaging_observer_handler\] table.

Use the `sn_notification` namespace to access the Messaging
API.

## Messaging - send(GlideRecord messagingApplication, String recipient, GlideRecord messagingContent, GlideRecord target) {#ariaid-title2}

Sends a custom message to a third-party application in response to a messaging event.
For example, you can send a custom welcome message to a Slack channel when the Now Actions
application installs.
Use this method in an action script in the Message Actions \[messaging_observer_handler\]
table.
{#MessagingScoped-send_O_S_O_O__table_l3g_zyn_zdb__entry__3}

| Name | Type | Description |
|-|-|-|
| messagingApplication | GlideRecord | Third-party application to send a message to from the Messaging Entities \[messaging_application\] table. |
| recipient | String | Recipient of the message. When the instance receives an inbound message, you can send a response to a Slack channel, Team, or individual user ID found in the inbound payload. |
| messagingContent | GlideRecord | Message content to send from the Messaging Contents \[messaging_content\] table. |
| target | GlideRecord | Record used to define dynamic field values in the message. Table must match the Target table field in the Messaging Contents record. If the Messaging Contents record does not use a target table, set the value to null. |
[Table 1. Parameters]

{#MessagingScoped-send_O_S_O_O__table_l3g_zyn_zdb} {#MessagingScoped-send_O_S_O_O__table_m3g_zyn_zdb__entry__2}

| Type | Description |
|-|-|
| void |   |
[Table 2. Returns]

{#MessagingScoped-send_O_S_O_O__table_m3g_zyn_zdb}  

    //Send a message to a Teams user
    var app = new GlideRecord('messaging_application');
    app.get('1f2d26527f4213007f005212bdfa9102');

    var content = new GlideRecord('messaging_content');
    content.get('17f1f9617320130082999cfd7bf6a706');

    sn_notification.Messaging.send(app, '29:1ojsgDg1xuA_jZ70PDI2_6E7mn7P6Mc0wK7z0n2lblL-SaNXYVI1cR7i6qncllAGvdmhy2-kXh76IEVpUHXdz3w', content, null);

    //Send a message to a Slack user
    var app = new GlideRecord('messaging_application');
    app.get('5d2e38c07f6113007f005212bdfa9160');

    var content = new GlideRecord('messaging_content');
    content.get('69c48ba77310130082999cfd7bf6a7af');

    sn_notification.Messaging.send(app, 'U8P706QFQ', content, null);

    //Send a message to a Slack channel
    var app = new GlideRecord('messaging_application');
    app.get('5d2e38c07f6113007f005212bdfa9160');

    var content = new GlideRecord('messaging_content');
    content.get('69c48ba77310130082999cfd7bf6a7af');

    sn_notification.Messaging.send(app, 'CA6232N65', content, null);