INKY n8n Node

REST API for INKY external partner integrations. Provides access to team metadata, billable usage data, and webhook event subscriptions.## StabilityEvery endpoint's path prefix states what it promises, so you can tell from the URL alone what you are depending on.- /v1 is stable. A breaking change ships as a new prefix, not an edit to this one.- /beta is not yet stable. These endpoints may change shape or be removed without notice, and move to /v2 once they settle. They are fully documented and callable, since beta means "no stability promise" rather than "hidden", but do not build a production integration against them. Every beta operation repeats this notice at the top of its description.When a beta endpoint is promoted, it answers on both prefixes for a deprecation window before the /beta path is retired, so an early integration is not broken by the promotion itself.## AuthenticationEvery endpoint requires an API key in the X-API-Key header, except /v1/status. /v1/openapi.json, which serves this document, is also unauthenticated; it is the API's reference rather than part of the API, and is not listed in paths.### Platform signature (partner integrations)Whether an endpoint requires an additional HMAC signature on top of the API key depends on your key's role, not on the endpoint alone.A key whose role is suffixed _integration (e.g. gradient_msp_integration) must sign every read on this API: /v1/me, the team and usage reads, and every GET on the /beta management families. A customer-issued key (external_api_user) does not. For it the check is a pass-through, and those endpoints behave exactly as the rest do. Writes are never signed.Each operation that can require a signature lists PLATFORM_SIGNATURE_INVALID among its 401 responses; that per-operation list is authoritative.Callers who must sign include two headers:- X-Inky-Timestamp, an integer unix-seconds timestamp. It must be within the server's configured skew window, 5 min by default.- X-Inky-Signature: v1=<hex>, the lowercase hex HMAC-SHA256 of the canonical string, whose fields are joined by a single ASCII LF (0x0A) byte: v1 <LF> <timestamp> <LF> <METHOD_UPPERCASE> <LF> <url-decoded-path>[?<raw-query-string>] <LF> <sha256_hex(raw_body)>. The path component is url-decoded; the query string is included in its raw, NOT url-decoded form (percent-encoded characters stay percent-encoded on both sides). The ?<raw-query-string> segment is appended only when a query string is present, so a request with no query has no trailing ?. Keyed with the shared platform secret.A signature is bound to the exact request body, method, and path, so it does not carry over to a request that differs in any of them. The same signature cannot be used twice inside the skew window: a repeat answers 401 PLATFORM_SIGNATURE_REPLAYED. Because the signed timestamp is in whole seconds, two identical requests signed in the same second carry the same signature, and only the first is accepted. To send the same request again, re-sign it with a fresh timestamp. Rotation is supported via two active secrets; either one verifies during the overlap. The shared secret lives between the peer platforms and is never exposed through the dashboard or customer-issued API keys.## Common response headersThese headers are not limited to success responses. INKY sets them once the request has got far enough to produce them, so a refusal raised after that point carries them too. A 429 RATE_LIMITED reports the rate-limit window it refused you under, and a 403 or 404 on a key expiring soon still says so.Authenticated endpoints may return:- X-RateLimit-Limit: requests allowed per window. Present when the call reached a rate limiter, including on the 429 that limiter raises- X-RateLimit-Remaining: requests remaining in the current window. 0 on a 429 RATE_LIMITED- X-RateLimit-Reset: the Unix time at which the current window resets. Pace against this rather than waiting to be refused; it is absolute, so it stays true if you cache it- X-API-Key-Expires-Soon: true: present when the API key expires within 30 days. INKY sets it once the key is validated, so it appears on refusals as well as successes. On a 401 that means only PLATFORM_SIGNATURE_INVALID or PLATFORM_SIGNATURE_REPLAYED, where the key itself was accepted and the signature over the request was not; the 401s raised before a key resolves carry neither header- X-API-Key-Expires-At: the ISO-8601 expiration timestamp, present only alongside X-API-Key-Expires-SoonEvery response, success or error, also carries:- X-Request-Id: an opaque per-request identifier. Quote it when contacting INKY support so the exact request can be located in our logs. INKY generates it server-side, so a value you send in is not used.## Common error responsesEvery endpoint except /v1/status may return 500 Internal Server Error with error code INTERNAL_ERROR for unexpected failures. /v1/status is a static health check that reaches no dependency, so it has no failure of its own to report. All authenticated endpoints may return 401 with error codes INVALID_API_KEY, MISSING_API_KEY, or EXPIRED_API_KEY.
Table of Contents
Installation
Follow the n8n community node installation guide.
Or install directly via npm:
npm install @avantguardllc/n8n-nodes-inky
Authentication
This node authenticates using an API Key.
| Setting |
Value |
| Type |
API Key |
| Sent in |
header |
| Header / Query name |
X-API-Key |
| Base URL |
https://api.inkyphishfence.com (editable in credentials) |
Tip: The Base URL can be changed in the credential settings if your instance uses a different host.
Resources & Operations
Base URL: https://api.inkyphishfence.com
Status
|
Endpoint |
Description |
π΅ GET |
/v1/status |
Health check |
Authentication
|
Endpoint |
Description |
π΅ GET |
/v1/me |
Get current API key info |
Teams
|
Endpoint |
Description |
π΅ GET |
/v1/teams |
List teams |
π΅ GET |
/v1/teams/{team_id} |
Get team details |
Admins
|
Endpoint |
Description |
π΅ GET |
/beta/admins |
List admins |
π΅ GET |
/beta/teams/{team_id}/admins |
List admins for a team |
π’ POST |
/beta/teams/{team_id}/admins |
Add an admin to a team |
π΅ GET |
/beta/teams/{team_id}/admins/{email} |
Get a single admin on a team |
π£ PATCH |
/beta/teams/{team_id}/admins/{email} |
Change an admin's role on a team |
π΄ DELETE |
/beta/teams/{team_id}/admins/{email} |
Remove an admin from a team |
VIPs
|
Endpoint |
Description |
π΅ GET |
/beta/vips |
List VIPs |
π΅ GET |
/beta/teams/{team_id}/vips |
List VIPs for a team |
π’ POST |
/beta/teams/{team_id}/vips |
Add a VIP to a team |
π’ POST |
/beta/teams/{team_id}/vips:batch |
Add many VIPs to a team (bulk) |
π΅ GET |
/beta/teams/{team_id}/vips/{entry_id} |
Get a single VIP on a team |
π£ PATCH |
/beta/teams/{team_id}/vips/{entry_id} |
Change a VIP on a team |
π΄ DELETE |
/beta/teams/{team_id}/vips/{entry_id} |
Remove a VIP from a team |
Usage
|
Endpoint |
Description |
π΅ GET |
/v1/usage |
Get billable usage |
π΅ GET |
/v1/usage/history |
Get billable usage history |
BlockList
|
Endpoint |
Description |
π΅ GET |
/beta/block_list |
List block-list entries |
π΅ GET |
/beta/teams/{team_id}/block_list |
List block-list entries for a team |
π’ POST |
/beta/teams/{team_id}/block_list |
Add a block-list rule to a team |
π’ POST |
/beta/teams/{team_id}/block_list:batch |
Add many block-list rules to a team (bulk) |
π΅ GET |
/beta/teams/{team_id}/block_list/{entry_id} |
Get a single block-list entry on a team |
π£ PATCH |
/beta/teams/{team_id}/block_list/{entry_id} |
Update a block-list rule on a team |
π΄ DELETE |
/beta/teams/{team_id}/block_list/{entry_id} |
Remove a block-list rule from a team |
AllowList
|
Endpoint |
Description |
π΅ GET |
/beta/allow_list |
List allow-list entries |
π΅ GET |
/beta/teams/{team_id}/allow_list |
List allow-list entries for a team |
π’ POST |
/beta/teams/{team_id}/allow_list |
Add an allow-list rule to a team |
π΅ GET |
/beta/teams/{team_id}/allow_list/{entry_id} |
Get one allow-list entry |
π£ PATCH |
/beta/teams/{team_id}/allow_list/{entry_id} |
Update an allow-list rule |
π΄ DELETE |
/beta/teams/{team_id}/allow_list/{entry_id} |
Delete an allow-list rule |
π’ POST |
/beta/teams/{team_id}/allow_list:batch |
Add many allow-list rules to a team (bulk) |
ReportedMail
|
Endpoint |
Description |
π’ POST |
/beta/teams/{team_id}/reported_mail/{record_id}:remediate |
Remediate a reported-mail row |
π’ POST |
/beta/teams/{team_id}/reported_mail/{record_id}/items/{item_id}/reports/{report_id}:review |
Review a user report |
π΅ GET |
/beta/teams/{team_id}/reported_mail/{record_id}/items/{item_id}/actions |
List an item's available actions |
π’ POST |
/beta/teams/{team_id}/reported_mail/{record_id}/items/{item_id}/actions:apply |
Apply an item action |
π΅ GET |
/beta/reported_mail |
List reported mail across the estate |
π΅ GET |
/beta/teams/{team_id}/reported_mail |
List a team's reported mail |
π΅ GET |
/beta/teams/{team_id}/reported_mail/{record_id} |
Get one reported-mail row |
π’ POST |
/beta/reported_mail:remediate |
Bulk-remediate reported mail |
π’ POST |
/beta/reported_mail:dismiss |
Bulk-dismiss reported mail |
π’ POST |
/beta/teams/{team_id}/reported_mail/{record_id}/items/{item_id}:remediate |
Remediate one message copy |
Reference
|
Endpoint |
Description |
π΅ GET |
/beta/result_types |
List verdict types |
Messages
|
Endpoint |
Description |
π΅ GET |
/beta/teams/{team_id}/messages |
Search a team's messages |
Statistics
|
Endpoint |
Description |
π΅ GET |
/beta/teams/{team_id}/statistics |
A team's daily message counts by verdict |
π΅ GET |
/beta/teams/{team_id}/statistics/reasons |
A team's daily message counts by reason |
π΅ GET |
/beta/teams/{team_id}/statistics/result_categories |
A team's daily message counts by result category |
Compatibility
- n8n version: 1.0+ (tested on 2.x)
- Node.js version: 18+
License
MIT