Skip to main content

Full Experiance

Display all integration categories upfront, allowing customers to browse and select integrations based on their needs.

Generating a Service Key​

To generate a service key, make a POST request to the Unizo serviceKeys API endpoint with the required headers and payload.

Endpoint​

POST https://api.unizo.ai/api/v1/serviceKeys

Required Headers​

HeaderTypeRequiredDescription
apikeyStringYesA required access credential for authenticating API requests made to Unizo. The apikey identifies and authorizes the calling integration or service.

Sample Request Payload​

{
  "type": "INTEGRATION_TOKEN",
  "name": "organization-serviceKey",
  "subOrganization": {
    "name": "Acme Inc",
    "externalKey": "68cc5de0-dd15-41c6-9404-18b9cfb3ed3b"
  },
  "integration": {
    "type": "GENERIC",
    "target": {
      "type": "Category",
      "categorySelectors": [
        {
          "type": "SCM"
        }
      ]
    }
  },
  "dockProfile": {
    "id": "e0eefe2d-ba39-43fe-a04e-758ccb25ebe2"
  }
}

Sample Response Payload​

{
    "type": "INTEGRATION_TOKEN",
    "id": "197fca710090ef92f23c2d948f1",
    "state": "ACTIVE",
    "name": "organization-serviceKey",
    "displayId": "197fca710090ef92f23c2d948f1",
    "formDescriptorUrl": "https://dock.unizo.ai/links/197fca710090ef92f23c2d948f1",
    "frontendUrl": "https://dock.unizo.ai",
    "expirationDateTime": "1752292296",
    "subOrganization": {
        "externalKey": "214213423412312",
        "name": "Acme"
    },
    "integration": {
        "type": "GENERIC",
        "target": {
            "type": "Category",
            "categorySelectors": [
                {
                    "type": "TICKETING"
                }
            ]
        }
    },
    "environment": {
        "id": "c20ff3b9-ea57-4e37-a5c5-2cda4891722a"
    },
    "organization": {
        "id": "a2b852a0-934d-40d5-8555-1ef366bcccbe"
    }
}

Embedding the Connect UI​

The Unizo Connect UI can be embedded in your application’s web interface using an iframe. The src attribute of the iframe should be set to the formDescriptorUrl value received in the API response.

Example HTML​

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Unizo Connect UI</title>
</head>
<body>
  <iframe
    class="iframe-container"
    src="https://dock.unizo.ai/links/196fe56aaae7c00a284dd96452b"
    frameborder="0"
    allowfullscreen>
  </iframe>
</body>
</html>

Notes​

  • Ensure the formDescriptorUrl from the API response is used as the src attribute for the iframe.
  • Widget-based integrations for the Connect UI are coming soon.

For additional support, contact our team at support@unizo.ai.