Skip to main content


ZITADEL provides the following modules.


This module provides functionality to call REST APIs.


    let http = require('zitadel/http')

fetch() function​

This function allows to call HTTP servers. The function does NOT fulfil the Fetch API specification.


  • url string
  • options
    Optional, containing custom settings that you want to apply to the request.
    • headers
      Overwrites the default headers. One of the following types
      • map[string] string
        The value is split into separate values after each comma ,.
      • map[string] Array of string
        The value is a string array
      • default:
        • Content-Type: application/json
        • Accept: application/json
    • method
      The request method. Allowed values are GET, POST, PUT, DELETE
    • body Object
      JSON representation


If the request was invalid, an error will be thrown, otherwise a Response object will be returned.

The object has the following fields and methods:

  • status number
    Status code of response
  • body string
    Return value
  • json() Object
    Returns the body as JSON object, or throws an error if the body is not a json object.
  • text() string
    Returns the body



The log module provides you with the functionality to log to stdout.


   let logger = require("zitadel/log")

log(), warn(), error() function​

The logger offers three distinct log levels (info, warn, and error) to effectively communicate messages based on their severity, enhancing debugging and troubleshooting efficiency. Use the function that reflects your log level.

  • log()
  • warn()
  • error()

Example​"This is an info log.")

logger.warn("This is a warn log.")

logger.error("This is an error log.")


  • msg string
    The message you want to print out.


This module provides functionality to generate a UUID


    let uuid = require("zitadel/uuid")

uuid.vX() function​

This function generates a UUID using google/uuid. vX allows to define the UUID version:

  • uuid.v1() string
    Generates a UUID version 1, based on date-time and MAC address
  • uuid.v3(namespace, data) string
    Generates a UUID version 3, based on the provided namespace using MD5
  • uuid.v4() string
    Generates a UUID version 4, which is randomly generated
  • uuid.v5(namespace, data) string
    Generates a UUID version 5, based on the provided namespace using SHA1


  • namespace UUID/string
    Namespace to be used in the hashing function. Either provide one of defined namespaces or a string representing a UUID.
  • data []byte/string
    data to be used in the hashing function. Possible types are []byte or string.


The following predefined namespaces can be used for uuid.v3 and uuid.v5:

  • uuid.namespaceDNS UUID
  • uuid.namespaceURL UUID
  • uuid.namespaceOID UUID
  • uuid.namespaceX500 UUID


let uuid = require("zitadel/uuid")
function setUUID(ctx, api) {
if (api.metadata === undefined) {

api.v1.user.appendMetadata('custom-id', uuid.v4());