Identifying accounts and account traits


Groups endpoint

To create accounts and record account traits, send a POST request to with a JSON payload containing:

  • api_key: your Sherlock API key
  • group_id: identifier of the group (must be a string)
  • traits: object containing key/value pairs of traits
  • timestamp: a unix timestamp in milliseconds, indicating the time at which the traits are current

The API will respond with a 202 Accepted if the request was accepted.

Example cURL request:

$ curl -XPOST \
    -H 'Content-Type: application/json' \
    -d '{"api_key":"xyzzy","group_id":"12345","traits":{"name":"Nike","mrr":3000},"timestamp":1553647710707}'