---
schema_version: "1"
id: 3ad7130c202d87eb103f4fd83ae6a3af300dfffb8f10ceb6698b01257ac1319b
title: ConnectApi.ActionLinkGroupDefinitionInput
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/apexref/apex_connectapi_input_action_link_group_definition.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_action_link_group_definition.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 85fc96bd1302d4ff1a26961ea8a1cbd1dd084bbbecf7276d480771f71775cf3e
description: The definition of an action link group. All action links must belong to a group. Action links in a group are mutually exclusive and share some properties. Define standalone actions in their own action group.
---
# ConnectApi.ActionLinkGroupDefinitionInput

The definition of an action link group. All action links must belong to a group. Action links in a group are mutually exclusive and share some properties. Define standalone actions in their own action group.

Action link definition can be sensitive to a third party (for example, OAuth bearer token headers). For this reason, only calls made from the Apex namespace that created the action link definition can read, modify, or delete the definition. In addition, the user making the call must have created the definition or have View All Data permission.

<table class="featureTable sort_table" summary="">
          <thead class="thead sorted" align="left">
            <tr>
              <th class="featureTableHeader vertical-align-top " id="d538313e34">Property</th>
              <th class="featureTableHeader vertical-align-top " id="d538313e36">Type</th>
              <th class="featureTableHeader vertical-align-top " id="d538313e38">Description</th>
              <th class="featureTableHeader vertical-align-top " id="d538313e40">Required or Optional</th>
              <th class="featureTableHeader vertical-align-top " id="d538313e42">Available Version</th>
            </tr>
          </thead>
          <tbody class="tbody">
            <tr>
              <td class="entry" headers="d538313e34 d538313e42" data-title="Property"><samp class="codeph apex_code">actionLinks</samp></td>

              <td class="entry" headers="d538313e36" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list" title="Contains methods for the List collection type.">List</a>&lt;<a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_action_link_definition.htm#apex_connectapi_input_action_link_definition" title="The definition of an action link. An action link is a button on a feed element. Clicking an action link can take a user to a Web page, initiate a file download, or invoke an API call to Salesforce or to an external server. An action link includes a URL and an HTTP method, and can include a request body and header information, such as an OAuth token for authentication. Use action links to integrate Salesforce and third-party services into the feed so that users can drive productivity and accelerate innovation."><samp class="codeph apex_code">ConnectApi.​ActionLink​DefinitionInput</samp></a>&gt;
              </td>

              <td class="entry" headers="d538313e38" data-title="Description">The action links that make up this group. <p class="p">Within an action link group, action links are displayed in the order listed in the <samp class="codeph nolang">actionLinks</samp> property of the <samp class="codeph apex_code">ConnectApi.ActionLinkGroup​DefinitionInput</samp> class. Within a feed item, action link groups are displayed in the order specified in the <samp class="codeph nolang">actionLinkGroupIds</samp> property of the <samp class="codeph apex_code">ConnectApi.AssociatedActions​CapabilityInput</samp> class.</p>
                <p class="p">You can create up to three action links in a <samp class="codeph nolang">Primary</samp> group and up to four in an <samp class="codeph nolang">Overflow</samp> group.</p>
              </td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">Required to instantiate this action link group without a template. <p class="p">To
                  instantiate from a template, don’t specify a value.</p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d538313e34 d538313e42" data-title="Property"><samp class="codeph apex_code">category</samp></td>

              <td class="entry" headers="d538313e36" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/connectAPI_enums.htm#PlatformActionGroupCategory"><samp class="codeph apex_code">ConnectApi.​PlatformAction​GroupCategory</samp></a></td>

              <td class="entry" headers="d538313e38" data-title="Description">Indicates the priority and relative locations of action links in an associated
                feed item. Values are:<ul class="ul bulletList">
                  <li class="li">
                    <samp class="codeph nolang">Primary</samp>—The action link group is displayed in the body of the feed element.
                  </li>
                  <li class="li">
                    <samp class="codeph nolang">Overflow</samp>—The action link group is displayed in the overflow menu of the feed element.
                  </li>
                </ul>
              </td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">Required to instantiate this action link group without a template. <p class="p">To
                  instantiate from a template, don’t specify a value.</p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d538313e34 d538313e42" data-title="Property"><samp class="codeph apex_code">executions​Allowed</samp></td>

              <td class="entry" headers="d538313e36" data-title="Type"><a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/connectAPI_enums.htm#ActionLinkExecutionsAllowed"><samp class="codeph apex_code">ConnectApi.​ActionLink​ExecutionsAllowed</samp></a></td>

              <td class="entry" headers="d538313e38" data-title="Description">Defines the number of times an action link can be executed. Values are:<ul class="ul bulletList">
                  <li class="li">
                    <samp class="codeph nolang">Once</samp>—An action link can be executed only one time across all users.
                  </li>
                  <li class="li">
                    <samp class="codeph nolang">OncePerUser</samp>—An action link can be executed only one time for each user.
                  </li>
                  <li class="li">
                    <samp class="codeph nolang">Unlimited</samp>—An action link can be executed an unlimited number of times by each user. If the action link’s <samp class="codeph nolang">actionType</samp> is <samp class="codeph nolang">Api</samp> or <samp class="codeph nolang">ApiAsync</samp>, you can’t use this value.
                  </li>
                </ul>
              </td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">Required to instantiate this action link group without a template. <p class="p">To
                  instantiate from a template, don’t specify a value.</p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

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

              <td class="entry" headers="d538313e36" data-title="Type"><samp class="codeph apex_code"><span class="keyword">Datetime</span></samp></td>

              <td class="entry" headers="d538313e38" data-title="Description">ISO 8601 date string, for example, 2011-02-25T18:24:31.000Z, that represents the date and time this action link group is removed from associated feed items and can no longer be executed. The <samp class="codeph nolang">expirationDate</samp> must be within one year of the creation date.<p class="p" id="expirationDateRec"><a name="expirationDateRec"><!-- --></a>If the action link group definition includes an OAuth
                  token, it is a good idea to set the expiration date of the action link group to
                  the same value as the expiration date of the OAuth token so that users can’t
                  execute the action link and get an OAuth error.</p>
                <p class="p">To set a date when
                  instantiating from a template, see Set the Action Link Group Expiration Time in
                  <a class="xref" href="https://help.salesforce.com/s/articleView?id=platform.action_link_group_template_design.htm&amp;type=5&amp;language=en_US" target="_blank" title="HTML (New Window)">Design
                    Action Link Templates</a>.
                </p>
              </td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">Required to instantiate this action link group without a template. <p class="p">Optional
                  to instantiate from a template.</p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d538313e34 d538313e42" data-title="Property"><samp class="codeph apex_code">templateBindings</samp></td>

              <td class="entry" headers="d538313e36" data-title="Type">
                <a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_methods_system_list.htm#apex_methods_system_list" title="Contains methods for the List collection type.">List</a>&lt;<a class="xref" href="https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_connectapi_input_action_link_template_binding.htm#apex_connectapi_input_action_link_template_binding" title="A key-value pair to fill in a binding variable value from an action link template."><samp class="codeph apex_code">ConnectApi.​ActionLink​TemplateBindingInput</samp></a>&gt;
              </td>

              <td class="entry" headers="d538313e38" data-title="Description">A collection of key-value pairs to fill in binding variable values or a custom user alias from an action link template. To instantiate this action link group from an action link template that uses binding variables, you must provide values for all the variables. See Define Binding Variables in <a class="xref" href="https://help.salesforce.com/s/articleView?id=platform.action_link_group_template_design.htm&amp;type=5&amp;language=en_US" target="_blank" title="HTML (New Window)">Design Action Link Templates</a>.</td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">To instantiate without a template, don’t specify a value.<p class="p"> Required to
                  instantiate this action link group from a template that uses binding variables.
                </p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

            <tr>
              <td class="entry" headers="d538313e34 d538313e42" data-title="Property"><samp class="codeph apex_code">templateId</samp></td>

              <td class="entry" headers="d538313e36" data-title="Type"><samp class="codeph apex_code"><span class="keyword">String</span></samp></td>

              <td class="entry" headers="d538313e38" data-title="Description"><span class="ph" id="templateId"><a name="templateId"><!-- --></a>The ID of the action link group template from which to
                  instantiate this action link group. </span></td>

              <td class="entry" headers="d538313e40" data-title="Required or Optional">To instantiate without a template, don’t specify a value.<p class="p"> Required to
                  instantiate this action link group from a template. </p>
              </td>

              <td class="entry" headers="d538313e34 d538313e42" data-title="Property">33.0</td>

            </tr>

          </tbody>
        </table>

#### See Also

- [Define an Action Link and Post with a Feed Element](https://developer.salesforce.com/docs/atlas.en-us.264.0.apexcode.meta/apexcode/connectapi_examples_define_post_action_link.htm "Define an Action Link and Post with a Feed Element - HTML (New Window)")
- [Define an Action Link in a Template and Post with a Feed Element](https://developer.salesforce.com/docs/atlas.en-us.264.0.apexcode.meta/apexcode/connectapi_examples_define_post_action_link_template.htm "Define an Action Link in a Template and Post with a Feed Element - HTML (New Window)")
- [createActionLinkGroupDefinition​(communityId, actionLinkGroup)](https://developer.salesforce.com/docs/atlas.en-us.apexref.meta/apexref/apex_ConnectAPI_ActionLinks_static_methods.htm#apex_ConnectAPI_ActionLinks_createActionLinkGroupDefinition_1 "Create an action link group definition. To associate an action link group with a feed element, first create an action link group definition. Then post a feed element with an associated actions capability.")