---
schema_version: "1"
id: 22234eb106ad13414458d04a455b04465a7b25cc018e5e6b1c00098cc1a5b413
title: ConnectApi.AnnouncementInput
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_announcement.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_announcement.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 15f771d70fe19d631c3eea97352b3873d5dcd80ea5686a012e4344ade8c25086
description: An announcement.
---
# ConnectApi.AnnouncementInput

An announcement.

<table class="featureTable sort_table" summary="">





          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader  " id="d551728e46">Property</th>

              <th class="featureTableHeader  " id="d551728e49">Type</th>

              <th class="featureTableHeader  " id="d551728e52">Description</th>

              <th class="featureTableHeader  " id="d551728e55">Required or Optional</th>

              <th class="featureTableHeader  " id="d551728e58">Available </th>

            </tr>

          </thead>

          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph nolang">body</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type"><samp class="codeph apex_code"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_msgBody.htm" title="Add rich messages to feed items and comments.">ConnectApi.MessageBodyInput</a></samp></td>

              <td class="entry" headers="d551728e52" data-title="Description">Text of the announcement.</td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Required for creating an announcement if <samp class="codeph apex_code">feedItemId</samp> isn’t specified<p class="p">Don’t specify for updating an
                  announcement.</p>
              </td>

              <td class="entry" headers="d551728e58" data-title="Available">31.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph apex_code">expirationDate</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type">Datetime</td>

              <td class="entry" headers="d551728e52" data-title="Description">The Salesforce UI displays an announcement until 11:59 p.m. on this date unless another announcement is posted first. The Salesforce UI ignores the time value in the <samp class="codeph nolang">expirationDate</samp>. However, you can use the time value to create your own display logic in your own UI.</td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Required for creating an announcement<p class="p">Optional for updating an
                  announcement</p>
              </td>

              <td class="entry" headers="d551728e58" data-title="Available">31.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph apex_code">feedItemId</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type">String</td>

              <td class="entry" headers="d551728e52" data-title="Description"><span class="ph" id="feedItemIdDesc"><a name="feedItemIdDesc"><!-- --></a>ID of an <samp class="codeph apex_code">AdvancedTextPost</samp> feed item that is the body of the
                  announcement.</span></td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Required for creating an announcement if <samp class="codeph apex_code">body</samp> isn’t specified<p class="p">Don’t specify for updating an
                  announcement.</p>
              </td>

              <td class="entry" headers="d551728e58" data-title="Available">36.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph apex_code">isArchived</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type">Boolean</td>

              <td class="entry" headers="d551728e52" data-title="Description"><span class="ph" id="isArchivedDesc"><a name="isArchivedDesc"><!-- --></a>Specifies whether the announcement is
                  archived.</span></td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Optional</td>

              <td class="entry" headers="d551728e58" data-title="Available">36.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph apex_code">parentId</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type">String</td>

              <td class="entry" headers="d551728e52" data-title="Description">ID of the parent entity for the announcement, that is, a group ID when the announcement appears in a group.</td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Required for creating an announcement if <samp class="codeph apex_code">feedItemId</samp> isn’t specified<p class="p">Don’t specify for updating an
                  announcement.</p>
              </td>

              <td class="entry" headers="d551728e58" data-title="Available">36.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d551728e46" data-title="Property"><samp class="codeph apex_code">sendEmails</samp></td>

              <td class="entry" headers="d551728e49" data-title="Type">Boolean</td>

              <td class="entry" headers="d551728e52" data-title="Description"><span class="ph" id="sendEmailsDesc"><a name="sendEmailsDesc"><!-- --></a>Specifies whether the announcement is sent as an email
                  to all group members regardless of their email setting for the group. If Chatter
                  emails aren’t enabled for the organization, announcement emails aren’t sent.
                  Default value is <samp class="codeph apex_code"><span class="keyword">false</span></samp>.</span></td>

              <td class="entry" headers="d551728e55" data-title="Required or Optional">Optional for creating an announcement<p class="p">Don’t specify for updating an
                  announcement</p>
              </td>

              <td class="entry" headers="d551728e58" data-title="Available">36.0</td>

            </tr>

          </tbody>

        </table>

#### See Also

- [postAnnouncement(communityId, groupId, announcement)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_ChatterGroups_static_methods.htm#apex_ConnectAPI_ChatterGroups_postAnnouncement_2 "Post an announcement to a group.")
- [postAnnouncement(communityId, announcement)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_Announcements_static_methods.htm#apex_ConnectAPI_Announcements_postAnnouncement_3 "Post an announcement.")