POST
/
signals
curl --request POST \
  --url https://api.pipeium.com/signals \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "list_id": "550e8400-e29b-41d4-a716-446655440000",
    "level": "contact",
    "strategy": "record_wise",
    "signal": "current_role",
    "notify_mode": "on_change",
    "monitor_frequency": 7
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "detail": "Signal created"
}
Create a new signal to monitor changes in contacts or accounts. Signals can be configured to monitor individual records or grow lists based on criteria.

​
Body Parameters

​
list_id
string
required
The ID of the list to monitor
​
level
string
required
Level at which to monitor. Must be one of:
  • contact - Monitor individual contacts
  • account - Monitor companies/accounts
​
strategy
string
required
Signal monitoring strategy. Must be one of:
  • record_wise - Monitor existing records
  • grow_list - Add new records matching criteria
​
signal
string
required
Type of signal to monitor. Must be one of:
  • For contacts:
    • current_role - Monitor job role changes
    • deep_research - Custom research query
  • For accounts:
    • news - Company news monitoring
    • open_job_post - Job posting monitoring
    • deep_research - Custom research query
    • headcount - Employee headcount changes
​
metadata
object
Signal-specific configuration:
​
notify_mode
string
required
When to send notifications:
  • on_change - When monitored data changes
  • on_value - When data matches specific value
​
notify_value
string
Required for on_value notify mode. Value to match for notification.
​
monitor_frequency
number
required
How often to check for changes (in days). Must be between 4-30.

​
Response

​
id
string
ID of the created signal
​
detail
string
Success message
curl --request POST \
  --url https://api.pipeium.com/signals \
  --header 'Authorization: Bearer {api_key}' \
  --header 'Content-Type: application/json' \
  --data '{
    "list_id": "550e8400-e29b-41d4-a716-446655440000",
    "level": "contact",
    "strategy": "record_wise",
    "signal": "current_role",
    "notify_mode": "on_change",
    "monitor_frequency": 7
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "detail": "Signal created"
}