---
title: "Changes to Create Custom Domain"
method: POST
path: "/v3/portals/{portalId}/custom-domain"
---

# Changes to Create Custom Domain

`POST /v3/portals/{portalId}/custom-domain`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 4 of 30 revisions.

- **2025-11-06** `5d2b35832e3f`: 1 warning, 1 info
- **2025-10-02** `ecce2daf9de6`: 5 breaking, 1 info
- **2025-08-12** `b2800570b3e2`: 1 info
- **2025-04-22** `0f6e0fa4241c`: 1 warning, 5 info

## Changes

- **2025-11-06** `5d2b35832e3f`: 1 warning, 1 info
  - added the new `type` enum value to the `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/rule` response property for the response status `400`
  - added the new optional request property `ssl/skip_ca_check`
- **2025-10-02** `ecce2daf9de6`: 5 breaking, 1 info
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterChoiceItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterDependentItem]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMaximumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterMinimumLength]/source` became nullable for the status `400`
  - the response property `allOf[subschema #2]/invalid_parameters/items/oneOf[#/components/schemas/InvalidParameterStandard]/source` became nullable for the status `400`
  - added the optional property `ssl/skip_ca_check` to the response with the `201` status
- **2025-08-12** `b2800570b3e2`: 1 info
  - the request property `ssl/domain_verification_method` became optional
- **2025-04-22** `0f6e0fa4241c`: 1 warning, 5 info
  - added the new `custom_certificate` enum value to the `ssl/domain_verification_method` response property for the response status `201`
  - added the new optional request property `ssl/custom_certificate`
  - added the new optional request property `ssl/custom_private_key`
  - added the new `custom_certificate` enum value to the request property `ssl/domain_verification_method`
  - added the optional property `ssl/expires_at` to the response with the `201` status
  - added the optional property `ssl/uploaded_at` to the response with the `201` status

---

[Operation](https://skmtc.dev/kong/apis/konnect-api-beta/docs/v3/portals/:portalId/custom-domain/post.md) - [API](https://skmtc.dev/kong/apis/konnect-api-beta.md) - [Page](https://skmtc.dev/kong/apis/konnect-api-beta/changes/v3/portals/:portalId/custom-domain/post)