---
title: "Create new service"
method: POST
path: "/v1/api/services"
tags: ["Services"]
---

# Create new service

`POST /v1/api/services`

This endpoint creates a new service. And assigns to gateway account ids (Optional). <br> `service_name` keys are supported ISO-639-1 language codes and values are translated service names | key must be `"en"` or `"cy"`

## Request body

- string

## Response `201`

Created

- Service
  - `_links` Link[]
    - `href` string
    - `method` string
    - `rel` string
  - `agent_initiated_moto_enabled` boolean
  - `archived` boolean
  - `archived_date` string, date-time
  - `collect_billing_address` boolean
  - `created_date` string, date-time
  - `current_go_live_stage` 'NOT_STARTED' | 'ENTERED_ORGANISATION_NAME' | 'ENTERED_ORGANISATION_ADDRESS' | 'CHOSEN_PSP_ADYEN' | 'CHOSEN_PSP_STRIPE' | 'CHOSEN_PSP_GOV_BANKING_WORLDPAY' | 'GOV_BANKING_MOTO_OPTION_COMPLETED' | 'TERMS_AGREED_ADYEN' | 'TERMS_AGREED_STRIPE' | 'TERMS_AGREED_GOV_BANKING_WORLDPAY' | 'DENIED' | 'LIVE'
  - `current_psp_test_account_stage` 'NOT_STARTED' | 'REQUEST_SUBMITTED' | 'CREATED'
  - `custom_branding` object
  - `default_billing_address_country` string
  - `experimental_features_enabled` boolean
  - `external_id` string
  - `gateway_account_ids` string[]
  - `id` integer
  - `internal` boolean
  - `merchant_details` MerchantDetails
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_postcode` string
    - `email` string
    - `name` string
    - `telephone_number` string
    - `url` string
  - `name` string
  - `redirect_to_service_immediately_on_terminal_state` boolean
  - `sector` string
  - `service_features` object
  - `service_name` object
  - `takes_payments_over_phone` boolean
  - `went_live_date` string, date-time

## Other responses

- `400` — Service name keys must be one of 'en' (English) or 'cy' (Welsh)
- `409` — Gateway account IDs provided has already been assigned to another service
- `500` — Invalid JSON payload

## Changes

- **2026-08-03** `17f1bf916172` — 1 breaking
  - the `service_features` response's property type/format changed from `array`/`` to `object`/`` for status `201`
- **2026-07-21** `1f9978f5e174` — 1 info
  - added the optional property `service_features` to the response with the `201` status
- **2026-06-15** `7c2ffa5bfb93` — 2 warning
  - added the new `CHOSEN_PSP_ADYEN` enum value to the `current_go_live_stage` response property for the response status `201`
  - added the new `TERMS_AGREED_ADYEN` enum value to the `current_go_live_stage` response property for the response status `201`
- **2024-09-09** `4b7f0008519e` — 1 info
  - added the non-success response with the status `400`
- **2023-11-09** `de931ca0f448` — 1 info
  - added the optional property `archived_date` to the response with the `201` status

[Full history](https://skmtc.dev/government-digital-service/apis/adminusers-api/changes/v1/api/services/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/adminusers-api.md) · [All operations](https://skmtc.dev/government-digital-service/apis/adminusers-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/government-digital-service/adminusers-api/revisions/8f9d543f352b/schema)