---
schema_version: "1"
id: 4dd047282e327a301b985cf6c80750f7847fd0e3df10adc427fb198e096e694c
title: DirectMessage
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_directmessage.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_directmessage.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: d10c723f9f61a78db97945035446b66ea4a71e6a07e885aefff3f1d5e09a5c7e
description: Represents a direct message conversation between multiple users in Chatter. This object is available in API version 38.0 and later.
---
# DirectMessage

Represents a direct message conversation between multiple users in Chatter. This object is available in API version 38.0 and later.

## Supported Calls

describeSObjects(), query(), retrieve(), update()

## Special Access Rules

You must have the Manage Chatter Messages and Direct Messages permission enabled to access the DirectMessage object.

## Fields

| Field | Details |
| --- | --- |
| Name | 
Type

string

Properties

Filter, Group, idLookup, Sort, Update

Description

A default value that isn’t visible to users.



 |
| Subject | 

Type

string

Properties

Filter, Group, Nillable, Sort, Update

Description

Subject of the overall direct message conversation.



 |

## Usage

DirectMessage is an object used by Salesforce to control DirectMessage conversations. It represents a record of a direct message conversation, but doesn’t include conversation data, such as posts or comments. It is most frequently used to moderate direct message data in order to meet data compliance regulations.