Auth Service icon

Auth Service

Interact with an Auth Service instance — validate tokens, manage zones and tokens

Actions7

Create Zone

AI-generated

Summary

Creates a new zone in an Auth Service instance by sending a POST to {baseUrl}/tokens/zones with a name and optional description. Requires the zones:write scope on the configured credential.

Inputs

  • Zone Name (required) — Name for the new zone, e.g. "orders" or "billing". Sent as name in the request body.
  • Description — Optional description for the zone. Sent as description; defaults to an empty string if left blank.

Output shape

One output item per input item, containing the JSON response from the Auth Service (the created zone as returned by the API).

The exact response fields depend on the Auth Service API and aren't defined in the node. Authentication uses the authServiceApi credential. If 'Continue On Fail' is enabled, a failed item returns { error, operation } instead of stopping the workflow; otherwise the error is thrown. Zones created here show up in the Zone dropdowns of the other operations.

Examples

Example 1: Provision a new 'billing' zone before issuing tokens for it.

Operation: Create Zone; Zone Name: billing; Description: Billing service access.

Example 2: Create one zone per incoming item from a list of service names.

Zone Name set to expression {{$json.serviceName}}; Description left empty. The node runs once per input item.

Links

Discussion