Create Signal

Creates a new Signal.

Create a signal.

post

Header parameters

sessionTokenstringrequired

Session authentication token.

keyManagerTokenstringoptional

Key Manager authentication token.

Body

namestringoptional

Signal name

querystringoptional

The query used to define this signal. The query is defined as "field:value" pairs combined by the operators "AND" or "OR". Supported fields are (case-insensitive): "author", "hashtag" and "cashtag". MUST contain at least one "hashtag" or "cashtag" definition.

visibleOnProfilebooleanoptional

Whether the signal is visible on its creator's profile

companyWidebooleanoptional

Whether the signal is a push signal

Responses

application/json

application/json

application/json

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'youragentURL.symphony.com/agent/v1/signals/create' \
  --header 'sessionToken: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "text",
    "query": "text",
    "visibleOnProfile": true,
    "companyWide": true
  }'

200

400

401

403

451

500

200

{
  "name": "text",
  "query": "text",
  "visibleOnProfile": true,
  "companyWide": true,
  "id": "text",
  "timestamp": 1
}

Signal created.

Request Example

curl -X POST \  
  https://acme.symphony.com/agent/v1/signals/create \
  -H 'content-type: application/json' \
  -H 'keymanagertoken: KEYMANAGER_TOKEN' \
  -H 'sessiontoken: SESSION_TOKEN' \
  -d '{
	  "name": "hash and cash",
	  "query": "HASHTAG:hash AND CASHTAG:cash",
	  "visibleOnProfile": true,
    "companyWide": false
  }'

🚧 Known Limitations

• DLP only works with 1.53 version and onwards.

• To create a company-wide signal, the requesting user needs to have the canCreatePushedSignals entitlement.

• To send numeric cashtags as signals, add a * before the number, for example, $*122450.