Taps
Taps are the API tokens (fh_) that own a set of rules and that you stream from. Why to keep one tap per use case, and how to create and manage them.
A tap is an API token (prefixed fh_) scoped to an organization. It owns a set of
rules and is the thing you open a stream from. Think of one
tap per use case.
Why one tap per use case
Each tap has its own rule set, its own stream, and its own feed. Splitting use cases across taps keeps matches cleanly separated — e.g. a "brand mentions" tap and a "competitor news" tap each stream only their own matches, and you can revoke one without touching the other.
Creating and managing taps
- Dashboard — create, rename, and revoke taps from the Taps page.
- API — create and manage taps with a management key:
POST /v1/taps,GET /v1/taps,PUT /v1/taps/:id,DELETE /v1/taps/:id. See the API reference.
The number of taps an organization may hold depends on its plan (1 on Free, up to 100 on Business, unlimited on API-only).
Revoking a tap immediately invalidates its token and stops its streams. Anything using that token
will start receiving 401s.
Next steps
Rules
Add the queries a tap matches against.
Management-key endpoints
Create and manage taps over the API.