---
title: "Create a new Certificate"
url: "https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd/operations/create-certificate"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-runtime-groups-configuration-0/versions/af18902c-58f1-49d7-8ec2-9987b4e0d1bd.md

# Create a new Certificate

`POST` `/runtime-groups/{runtimeGroupId}/core-entities/certificates`

Operation ID: `create-certificate`

Create a new certificate with the provided details. Use this endpoint to add a new certificate to the system. The request body must include the certificate data and other details required for creating a new certificate.

## Path parameters

- `runtimeGroupId` (string, required) - The ID of your runtime group. This variable is available in the Konnect manager

## Request body

Content types: `application/json`

## Responses

- `200` - A certificate object represents a public certificate. These fields are _referenceable_.
- `400` - Invalid Certificate

## OpenAPI definition

```yaml
openapi: 3.0.0
info:
  title: Konnect Runtime Groups Configuration
  version: 0.0.1
servers:
  - url: https://us.api.konghq.com/v2
    description: United-States Production region
  - url: https://eu.api.konghq.com/v2
    description: Europe Production region
  - url: https://au.api.konghq.com/v2
    description: Australia Production region
  - url: https://me.api.konghq.com/v2
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v2
    description: India Production region
  - url: https://sg.api.konghq.com/v2
    description: Singapore Production region
paths:
  /runtime-groups/{runtimeGroupId}/core-entities/certificates:
    parameters:
      - name: runtimeGroupId
        in: path
        description: The ID of your runtime group. This variable is available in the
          Konnect manager
        required: true
        schema:
          type: string
          example: 9524ec7d-36d9-465d-a8c5-83a3c9390458
    post:
      operationId: create-certificate
      summary: Create a new Certificate
      description: Create a new certificate with the provided details. Use this
        endpoint to add a new certificate to the system. The request body must
        include the certificate data and other details required for creating a
        new certificate.
      requestBody:
        $ref: "#/components/requestBodies/cert-request"
      responses:
        "200":
          $ref: "#/components/responses/certificate_response"
        "400":
          description: Invalid Certificate
          content:
            application/json:
              schema:
                type: object
      tags:
        - Certificates
security:
  - konnectAccessToken: []
  - personalAccessToken: []
components:
  requestBodies:
    cert-request:
      content:
        application/json:
          schema:
            type: object
            properties:
              cert:
                description: "PEM-encoded public certificate chain of the SSL key pair. "
                type: string
                example: -----BEGIN CERTIFICATE-----...,
              key:
                description: "PEM-encoded private key of the SSL key pair. "
                type: string
                example: -----BEGIN RSA PRIVATE KEY-----...
              cert_alt:
                description: "PEM-encoded public certificate chain of the alternate SSL key
                  pair. "
                type: string
              key_alt:
                description: "PEM-encoded private key of the alternate SSL key pair. "
                type: string
                example: -----BEGIN EC PRIVATE KEY-----...
              tags:
                description: >
                  An optional set of strings associated with the Certificate for
                  grouping and filtering.
                type: array
                items:
                  type: string
            required:
              - cert
              - key
            x-examples:
              Example:
                id: 7fca84d6-7d37-4a74-a7b0-93e576089a41
                created_at: 1422386534
                cert: -----BEGIN CERTIFICATE-----...
                key: -----BEGIN RSA PRIVATE KEY-----...
                cert_alt: -----BEGIN CERTIFICATE-----...
                key_alt: -----BEGIN EC PRIVATE KEY-----...
                snis:
                  - foo.test
                  - example.com
                tags:
                  - user-level
                  - low-priority
  responses:
    certificate_response:
      description: A certificate object represents a public certificate. These fields
        are _referenceable_.
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                description: An array containing certificate information.
                type: array
                items:
                  type: object
                  properties:
                    cert:
                      description: PEM-encoded public certificate chain of the SSL key This field is
                        referenceable and can be stored in a vault
                      type: string
                      example: -----BEGIN CERTIFICATE-----\ncertificate-content\n-----END
                        CERTIFICATE-----
                    created_at:
                      description: Unix epoch when the resource was created
                      type: integer
                      example: 1422386534
                    id:
                      description: The UUID representation of the certificate object.
                      type: string
                      example: 7fca84d6-7d37-4a74-a7b0-93e576089a41
                    key:
                      description: PEM-encoded private key of the SSL key pair. This field is
                        _referenceable_, which means it can be securely stored
                        as a
                        [secret](/gateway/latest/plan-and-deploy/security/secrets-management/getting-started)
                        in a vault. References must follow a [specific
                        format](/gateway/latest/plan-and-deploy/security/secrets-management/reference-format).
                      type: string
                      example: " -----BEGIN RSA PRIVATE KEY-----..."
                    metadata:
                      description: metadata obtained from the certificate
                      type: object
                      properties:
                        expiry:
                          description: The expiration date of the certificate
                          type: string
                          example: "4840697418"
                        issuer:
                          description: Information about the certificate issuer
                          type: string
                          example: CN=Example certificate name Self-Signed Certificate,O=example\,
                            https://example.com,C=UA
                        key_usages:
                          description: Key usage flags for the certificate
                          type: array
                          items:
                            type: string
                            example: KEY_USAGE_TYPE_KEY_CERT_SIGN
                          example:
                            - KEY_USAGE_TYPE_DIGITAL_SIGNATURE
                            - KEY_USAGE_TYPE_KEY_CERT_SIGN
                            - KEY_USAGE_TYPE_CRL_SIGN
                            - KEY_USAGE_TYPE_ENCIPHER_ONLY
                        subject:
                          description: Information about the certificate
                          type: string
                          example: CN=cert_name,O=Example\, https://example.com,C=UA
                    tags:
                      description: An optional set of strings associated with the Certificate for
                        grouping and filtering
                      type: array
                      items:
                        type: string
                        example: high-level
                      example:
                        - high-level
                        - temporary
                    updated_at:
                      description: Unix epoch when the resource was updated
                      type: integer
                      example: 1422386534
            x-examples:
              Example 1:
                data:
                  - cert: |-
                      -----BEGIN CERTIFICATE-----
                      MIIDgzCCAmugAwIBAgIEV6GD9DANBgkqhkiG9w0BAQsFADBbMScwJQYDVQQDDB5SZWdlcnkgU2Vs
                      Zi1TaWduZWQgQ2VydGlmaWNhdGUxIzAhBgNVBAoMGlJlZ2VyeSwgaHR0cHM6Ly9yZWdlcnkuY29t
                      MQswCQYDVQQGEwJVQTAgFw0yMzA1MjUwMDAwMDBaGA8yMTIzMDUyNTE0MTAxOFowRTERMA8GA1UE
                      AwwIYXNkYXNkYXMxIzAhBgNVBAoMGlJlZ2VyeSwgaHR0cHM6Ly9yZWdlcnkuY29tMQswCQYDVQQG
                      EwJVQTCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoCggEBAKodSp1dIdaK6BVj90gAWZFH5AcQ
                      HY/oRtmheZNWY+9kY3VtuIWVzhxuP3y+ZG5j/TuzDpIoH/aUfinwoQwDSgbhCrG7wbQhoihJQKU1
                      XUjodI8aayQdSiHkE6Q1DXAPnFVOWXmSSA0djRyvNH9ixqjNTBcibt0bCiV9iOt2t/QajEGdF6ia
                      Yf9kjLkxQ/4XWkNgwPhL4aSOOObrdT4pVphHBogfvIwtBL4fI8ZI2qojYtfJM8f/kMdScvN7aZ8r
                      0QKzapelJjFsMTIPOHmPg7HcKVjvpuVGCO9vAso/PURD+g6nXBxsrmQqkCe8Y/41tBJ5GF97+is4
                      oDuyQBjY2f8CAwEAAaNjMGEwDwYDVR0TAQH/BAUwAwEB/zAOBgNVHQ8BAf8EBAMCAYYwHQYDVR0O
                      BBYEFJgYiJ7UCq9XaLE9Y0vYfHBVWlLlMB8GA1UdIwQYMBaAFJgYiJ7UCq9XaLE9Y0vYfHBVWlLl
                      MA0GCSqGSIb3DQEBCwUAA4IBAQBMD8wnPXCYCxImu5+3fotKnmen4FnL1zd9E1nHFZbGvImsgUFz
                      kfK3KTNrihkqVSrSoP02mUvDVUDZDUU9Lwd9DzUsRT9QdoSnSKdcS5b31Dk8D8evR2zpYWBwJvaZ
                      rm3e3z/9zUXxo5W4Y8N4HL90HqTwA0L2KzPZoc3LaQTpbcPQy5C6BbPZ3eSJH4h7fX8V+korNDnN
                      u+y5qfAXs6YNPozsQeFKgIB673+nI+cC/Y5toDQbFA6ibcXLMszlsJVN+Ko1QalcgwZjX7jG1TbA
                      yrN1eYw5JwCJPLR5vXt+6qlQ0dHcAqlzb7VTiumzLPz72Z3atsfhJNpSQ3cvM+p7
                      -----END CERTIFICATE-----
                    created_at: 1685023857
                    id: e94215b0-9198-42ce-bf0b-98afff31b2a7
                    key: |-
                      -----BEGIN RSA PRIVATE KEY-----
                      MIIEpAIBAAKCAQEAqh1KnV0h1oroFWP3SABZkUfkBxAdj+hG2aF5k1Zj72RjdW24
                      hZXOHG4/fL5kbmP9O7MOkigf9pR+KfChDANKBuEKsbvBtCGiKElApTVdSOh0jxpr
                      JB1KIeQTpDUNcA+cVU5ZeZJIDR2NHK80f2LGqM1MFyJu3RsKJX2I63a39BqMQZ0X
                      qJph/2SMuTFD/hdaQ2DA+EvhpI445ut1PilWmEcGiB+8jC0Evh8jxkjaqiNi18kz
                      x/+Qx1Jy83tpnyvRArNql6UmMWwxMg84eY+DsdwpWO+m5UYI728Cyj89REP6Dqdc
                      HGyuZCqQJ7xj/jW0EnkYX3v6KzigO7JAGNjZ/wIDAQABAoIBAByut6f0zgHIhf0l
                      T8paFMAEKRRvySw8c8W6Di+jf1Ib0RE5oMUVTx1IEXhM+c4LGeV4+Vn3XfxLaUJV
                      CjJmU5L5Wr5A9BYVHaxBPZ8dck8aspx2Td5W+erg89baAxwD5c4UWc2/tlpPwz00
                      5VsdInXPt6am7Z5mMr3DftSEvdtwX+k2DQAHK+dpwe+w4P74ndmzWz9ljLlBi1Jq
                      To6xBtcpxAagLQccDV04Ml58pu81E4VY427pM9xg7RMb4bK18y4jm3YHUFNWy8dM
                      Hr38iPss8DDd1IGOPAkiim72ncun3adf97YGgdTM1odWJGFFydfWkDQadmmwhTYv
                      eBS2SXECgYEA4KtgbPsmy4G4VYuc4P0Zy/ZHPjEvhLx57h+mXUk1JZv6+Hp2F4Q9
                      eRt5D//Ca8wjDy1adr9OhZN66YS8U6Jg4scTselxpQc6RIclE6nSQpMEx5nzDFFc
                      PI3xmXJ3naoAXw1r3pkhyivrmZ5291qiIILVUDyQR/zK6bw/sILIi70CgYEAwdZR
                      psiZiaSCWArPQyzg5uLTbjvnB1qRAxluH6vwlowPYAK5FQnzDlEEVPPo3JdjAM8q
                      p4oLMYf3wJH8Ls8pOXqHRBBpwSNbmZZMR7L7ac8ls88/8WCOnvDiA7Ibv/v9+u9+
                      sm1q3af9dguwL7ji9+5WudmOpMl9WmoGaMDeWmsCgYEArN3wUaplTUzAgsHrsYnN
                      YYxbgNTjlSRYRQqBPWHozMlZr/q6BpovmpGy8sZ91+e4SiNBagEE7+5sMmV5aniU
                      R6mZ09ilIq+O+89ojdqq96KbmOExi5bGe6lT7hePRfbaVkjDaQE2aJKmswqkyuon
                      uRAyBYy0D0/I6VN5Rd07ZZkCgYA3KSBPUCKxUsls+JaGzUyrJ713T0CtjQ5bTW9T
                      QADVNsJhViUJYa1zU4biDg8kR0h7QHko+FW7ILBWcrTLNVTL8JxxuCIAPmmgyW6n
                      sL1vHO3jv4S40fuEK5SF7LeM6M8cC++IIy8YKOguIaFf00NzvrWbadf3+QbdJfLw
                      +IHORQKBgQDOGcFOPRUV48emb6wkm45WYVMsBIsbiAwKbZ9uLdo108vK5x/nlE8Z
                      OXC1xqkec312HAzzjCUxKpSfTaIr1gV6YDGDEeHrYZrwsNo2Q6mBRbL/ZweDTegd
                      ggsmaDVo4kHoApfm7qi+BwCNnehxUR2FhBPs57vHZXYbQBr4unlWGA==
                      -----END RSA PRIVATE KEY-----
                    metadata:
                      expiry: "4840697418"
                      issuer: CN=Regery Self-Signed Certificate,O=Regery\, https://regery.com,C=UA
                      key_usages:
                        - KEY_USAGE_TYPE_DIGITAL_SIGNATURE
                        - KEY_USAGE_TYPE_KEY_CERT_SIGN
                        - KEY_USAGE_TYPE_CRL_SIGN
                        - KEY_USAGE_TYPE_ENCIPHER_ONLY
                      subject: CN=asdasdas,O=Regery\, https://regery.com,C=UA
                    tags:
                      - tag1
                    updated_at: 1685023857
  securitySchemes:
    konnectAccessToken:
      type: http
      scheme: bearer
      description: >-
        The Konnect access token is meant to be used by the Konnect dashboard
        and the decK CLI to

        authenticate with.
    personalAccessToken:
      type: http
      scheme: bearer
      description: The personal access token is meant to be used as an alternative to
        basic-auth when accessing Konnect via APIs. You can generate a Personal
        Access Token (PAT) from the personal access token page in the Konnect
        dashboard.
```
