---
title: "CreateIntegrationInstanceAuthCredential"
url: "https://us-prod.jeffyongtaotang.com/apis/konnect-service-catalog-1/versions/cdbef9b7-686c-4189-bbc8-55c727a972e8/schemas/CreateIntegrationInstanceAuthCredential"
---

> Full API specification: https://us-prod.jeffyongtaotang.com/apis/konnect-service-catalog-1/versions/cdbef9b7-686c-4189-bbc8-55c727a972e8.md

# CreateIntegrationInstanceAuthCredential

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Konnect Service Catalog
  version: 1.3.0
servers:
  - url: https://us.api.konghq.com/v1
    description: United-States Production region
  - url: https://eu.api.konghq.com/v1
    description: Europe Production region
  - url: https://au.api.konghq.com/v1
    description: Australia Production region
  - url: https://me.api.konghq.com/v1
    description: Middle-East Production region
  - url: https://in.api.konghq.com/v1
    description: India Production region
  - url: https://sg.api.konghq.com/v1
    description: Singapore Production region
components:
  schemas:
    CreateOAuthCredential:
      type: object
      description: Payload used to create an `OAuth` credential for an integration instance.
      additionalProperties: false
      required:
        - type
        - config
      properties:
        type:
          type: string
          enum:
            - oauth
          x-terraform-transform-const: true
        config:
          type: object
          title: CreateOAuthCredentialConfig
          additionalProperties: false
          required:
            - grant_type
            - code
            - redirect_uri
          properties:
            grant_type:
              type: string
              description: The OAuth 2.0 grant type used for authorization (e.g.,
                `authorization_code`).
              enum:
                - authorization_code
            code:
              type: string
              description: The authorization code used to exchange for an access token with
                the identity server.
              example: Yzk5ZDczMzRlNDEwY
            redirect_uri:
              type: string
              format: uri
              description: >
                The redirect URI submitted to the authorization server during
                the authentication request

                to retrieve the authorization code.
              example: https://cloud.konghq.com/us/service-catalog/integrations/pagerduty/oauth
    CreateGitHubAppInstallationCredential:
      type: object
      description: Payload used to create an `GitHub App Installation` credential for
        an integration instance.
      additionalProperties: false
      required:
        - type
        - config
      properties:
        type:
          type: string
          enum:
            - github_app_installation
          x-terraform-transform-const: true
        config:
          type: object
          title: CreateGitHubAppInstallationCredentialConfig
          additionalProperties: false
          required:
            - installation_id
            - code
          properties:
            installation_id:
              type: string
              description: The GitHub App installation ID.
              example: "46952218"
            code:
              type: string
              description: The authorization code used to exchange for a GitHub user-scoped
                access token.
              example: Yzk5ZDczMzRlNDEwY
            app_installed_by:
              type: string
              description: The GitHub user who installed the app
    CreateMultiKeyAuthCredential:
      writeOnly: true
      x-speakeasy-name-override: multi_key_auth
      type: object
      description: Payload used to create an `Multi Key` credential for an integration
        instance.
      additionalProperties: false
      required:
        - type
        - config
      properties:
        type:
          type: string
          enum:
            - multi_key_auth
          x-terraform-transform-const: true
        config:
          x-speakeasy-param-suppress-computed-diff: true
          x-speakeasy-param-force-new: true
          type: object
          title: CreateMultiKeyAuthCredentialConfig
          additionalProperties: false
          required:
            - headers
          properties:
            headers:
              type: array
              description: >
                A list of header key/value pairs used to transmit API
                credentials to the integration's external API.

                Header names are defined by the integration within its `Multi
                Key` authorization strategy definition.
              items:
                type: object
                required:
                  - name
                  - key
                properties:
                  name:
                    description: Name of the request header
                    type: string
                  key:
                    description: The key used to populate the request header
                    type: string
              example:
                - name: x-api-key
                  key: 9f2a3b4c8d6e7f00112233445566778899aabbccddeeff001122334455667788
    CreateAWSRoleDelegationAuthCredential:
      type: object
      description: Payload used to create an `AWS Role Delegation` credential for an
        integration instance.
      additionalProperties: false
      required:
        - type
        - config
      properties:
        type:
          type: string
          enum:
            - aws_role_delegation
        config:
          type: object
          title: CreateAWSRoleDelegationAuthCredentialConfig
          additionalProperties: false
          required:
            - role_arn
          properties:
            role_arn:
              type: string
              description: |
                The AWS Role ARN string
              example: arn:aws:iam::084735895545:role/KonnectServiceCatalogRole
    CreateIntegrationInstanceAuthCredential:
      title: CreateIntegrationInstanceAuthCredential
      oneOf:
        - $ref: "#/components/schemas/CreateOAuthCredential"
        - $ref: "#/components/schemas/CreateGitHubAppInstallationCredential"
        - $ref: "#/components/schemas/CreateMultiKeyAuthCredential"
        - $ref: "#/components/schemas/CreateAWSRoleDelegationAuthCredential"
```