website_visitors

Identify website visitor

Bind a visitor to a person of the team by hand ("the visitor from Acme's network yesterday is John"): person_sid, a live playtables person (cr_pp_), else 422 relation_not_found. It overrides any automatic bind; the visitor's open session and its sessions of the last 30 days nobody owned go to the person, their facts written by a queued job. On a site set to companies it is 409 invalid_transition (companies_level). The same person again changes nothing. Undo with unlink_website_visitor.

Contract:

  • MCP tool identify_website_visitor, registry package mcp.signals/website_visitors, mount signals.visits.
  • Operation action, response envelope action.
  • Flags: none.
post/api/website-visitors/{sid}/identify

Request

  • Base URL
    https://beta.getsales.io/signals/v1
  • Auth
    HTTP bearer and API key in header Team-SID

Path parameters

sidstring required

Website visitor sid (sg_wv_...).

Request body

person_sidstring required

The person this browser is (a live playtables person of the team). The bind is manual and overrides any automatic one.

Response

action success envelope.

successtrue required
operation'action' required
actionstring required

kebab-case verb; matches the route segment.

Changes

No recorded changes to this operation across all 1 revision of this API.