# Create Signal

## POST /v1/signals/create

> Create a signal.

```json
{"openapi":"3.0.1","info":{"title":"Agent API","version":"25.8.1"},"servers":[{"url":"youragentURL.symphony.com/agent"}],"paths":{"/v1/signals/create":{"post":{"tags":["Signals"],"summary":"Create a signal.","parameters":[{"name":"sessionToken","in":"header","description":"Session authentication token.","required":true,"schema":{"type":"string"}},{"name":"keyManagerToken","in":"header","description":"Key Manager authentication token.","schema":{"type":"string"}}],"requestBody":{"description":"Signal definition.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BaseSignal"}}},"required":true},"responses":{"200":{"description":"Signal created.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Signal"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"401":{"description":"Unauthorized: Session tokens invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"451":{"description":"Compliance Issues found in signal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/V2Error"}}}}}}}},"components":{"schemas":{"BaseSignal":{"type":"object","properties":{"name":{"type":"string","description":"Signal name"},"query":{"type":"string","description":"The query used to define this signal. The query is defined as \"field:value\" pairs combined by the operators\n\"AND\" or \"OR\". Supported fields are (case-insensitive): \"author\", \"hashtag\" and \"cashtag\".\nMUST contain at least one \"hashtag\" or \"cashtag\" definition.\n"},"visibleOnProfile":{"type":"boolean","description":"Whether the signal is visible on its creator's profile"},"companyWide":{"type":"boolean","description":"Whether the signal is a push signal"}}},"Signal":{"allOf":[{"$ref":"#/components/schemas/BaseSignal"},{"type":"object","properties":{"id":{"type":"string","description":"Signal ID"},"timestamp":{"type":"integer","description":"Timestamp when the signal was created, in milliseconds since Jan 1 1970","format":"int64"}}}]},"V2Error":{"required":["code","message"],"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"},"details":{"type":"object"}}}}}}
```

### Request Example

```bash
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`.