Track a competitor
add_competitorIdempotent
Resolve a public competitor using an accessible connected account and atomically save tracking with its first snapshot. External clients require Hive OAuth; workspace API keys cannot impersonate a signed-in user.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| handle | Yes | ||
| platform | Yes | ||
| approvalToken | No | ||
| idempotencyKey | Yes | A caller-generated unique key (8-200 characters). Reuse it only when retrying this exact write. |