---
title: "Create a test service."
method: PUT
path: "/configure/service"
tags: ["Configuration"]
---

# Create a test service.

`PUT /configure/service`

## Request body

- TestServiceCreationInfo — The data for the new test service.
  - `key` string, required — The unique key used to identify the service and its underlying domain parameter.
  - `address` string, required — The service's address as an absolute HTTP URL.
  - `description` string — The service's description.
  - `serviceType` 'messaging' | 'validation' | 'processing', required — The type of the service.
  - `apiType` 'soap' | 'rest' — The API type of the service.
  - `authBasicUsername` string — When HTTP basic authentication is used, this is the username to use.
  - `authBasicPassword` string — When HTTP basic authentication is used, this is the password to use.
  - `authTokenUsername` string — When the WS-Security UsernameToken profile is used, this is the username to use.
  - `authTokenPassword` string — When the WS-Security UsernameToken profile is used, this is the password to use.
  - `authTokenPasswordType` 'digest' | 'text' — When the WS-Security UsernameToken profile is used, this is the type of password provision to use.
  - `identifier` string — The service's reference identifier.
  - `version` string — The service's version.
  - `domain` string — The API key identifying the domain of the service. This is required if the community API key used for authentication refers to a community that is not linked to a specific domain.
  - `replaceExisting` boolean — In case the service information matches an existing domain parameter, this flag can be used to link the parameter with the service's definition.

## Response `200`

Test service created.

## Other responses

- `429` — Call rate limit threshold exceeded for this operation.
- `default` — The received request was invalid.

## Changes

- **2026-03-19** `7637660a4a6b` — 1 info
  - added the non-success response with the status `429`
- **2025-08-27** `eb833264bced` — 1 info
  - endpoint added
- **2022-06-27** `06f633c06bcd` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/changes/configure/service/put.md)

---

[API](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api.md) · [All operations](https://skmtc.dev/ec-jrc/apis/interoperability-test-bed-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ec-jrc/interoperability-test-bed-rest-api/revisions/433b3c0ae6d4/schema)