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:

Field

Type

Description

name

String

Signal name.

query

String

The 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.

visibleOnProfile

Boolean

Specifies whether the signal is visible on its creator's profile.

companyWide

Boolean

Specifies 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.

Entitlement

Capability

Can manage signal subscriptions

Allows you to subscribe specified users who cannot unsubscribe from a given signal.

Can create push signals

Allows you to create company-wide signals that cannot be unsubscribed.