---
title: "Setup"
description: "Create a Trust Registry Service instance for your organization."
stack: "Enterprise Stack (commercial) — version 0.21.0"
stack_version: "0.21.0"
stack_comparison: https://docs.walt.id/community-vs-enterprise.md
canonical_url: https://docs.walt.id/enterprise-stack/services/trust-registry-service/setup
generated: 2026-07-20
---
# Setup

Create a Trust Registry Service instance for your organization.

## Prerequisites

Ensure you have the `trust-registry` feature enabled via the `_features.conf`:

```hocon
enabledFeatures = [
    trust-registry
]
```

## Create the Service

**Option: CURL**

**Endpoint:** `POST /v1/{target}/resource-api/services/create` | [API Reference](https://enterprise.sandbox.walt.id/swagger/index.html#/Service%20%2F%20Resource/post_v1__target__resource_api_services_create)

##### Example Request

```bash
curl -X 'POST' \
  'https://{orgID}.enterprise-sandbox.waltid.dev/v1/{target}/resource-api/services/create' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer {yourToken}' \
  -H 'Content-Type: application/json' \
  -d '{
  "type": "trust-registry",
  "validateSignaturesByDefault": true
}'
```

**Path Parameters**

- `orgID`: _String_ - Your organization's Base URL prefix, e.g. `myorg.enterprise-sandbox.waltid.dev`.
- `target`: _String_ - The target path for the new service: `{organizationID}.{tenantID}.{serviceID}`, e.g. `myorg.tenant1.trust-registry`.

**Header Parameters**

- `Authorization`: _String_ - Bearer token for your organization.

**Body**

- `type`: _String_ - Must be `trust-registry`.
- `validateSignaturesByDefault`: _Boolean (optional)_ - Whether to validate XMLDSig signatures on TSL sources by default. Defaults to `true`.

---

##### Example Response

| Status | Description |
|--------|-------------|
| `201` | Service created successfully |
| `400` | Invalid request |
| `401` | Invalid or missing authentication token |

Once the service is created, load trust sources into it. See [Trust Source Management](https://docs.walt.id/enterprise-stack/services/trust-registry-service/trust-source-management.md).