Signal Object

The Signal object must be included in the body of the request. Signal objects can be subscribed and unsubscribed. The management of those subscriptions at both the individual and company-wide scales requires entitlements (see Entitlements below). The Signal object contains the following fields:

FieldTypeDescription
nameStringSignal name.
queryStringThe query used to define this signal and is composed of field:value pairs combined by the operators AND or OR.

Supported fields are: author, hashtag and cashtag (case-insensitive), and MUST contain at least one hashtag or cashtag definition.

This field uses the same syntax as the Message Search with these fields: HASHTAG, CASHTAG, AUTHOR, POSTEDBY.

POSTEDBY refers to wall posts by the end user.
visibleOnProfileBooleanSpecifies whether the signal is visible on its creator's profile.
companyWideBooleanSpecifies whether the signal is a company-wide signal. Users in the pod cannot unsubscribe. The Can create push signals entitlement is required to set this field. See Entitlements for more information.

Entitlements

The following entitlements, which appear in the Admin Portal, provide you with subscription capabilities for both specified users and company-wide pods.

EntitlementCapability
Can manage signal subscriptions Allows you to subscribe specified users who cannot unsubscribe from a given signal.
Can create push signalsAllows you to create company-wide signals that cannot be unsubscribed.