> ## Documentation Index
> Fetch the complete documentation index at: https://www.voiceflow.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect integration

> Stores the credentials for one `api-key` integration on the project, in the shape that integration expects; `oauth` and `app` integrations connect through the Voiceflow UI instead. The response carries only a confirmation message, so refetch the integration list to see the connection.



## OpenAPI

````yaml /specs-prettified/realtime/openapi.stable.json post /v1/stable/integration/{integration}
openapi: 3.0.0
info:
  title: Realtime
  description: Realtime gateway API service
  version: 1.0.0
  contact: {}
servers:
  - url: https://realtime-api.voiceflow.com
security: []
tags: []
paths:
  /v1/stable/integration/{integration}:
    post:
      tags:
        - Integration
      summary: Connect integration
      description: Stores the credentials for one `api-key` integration on the
        project, in the shape that integration expects; `oauth` and `app`
        integrations connect through the Voiceflow UI instead. The response
        carries only a confirmation message, so refetch the integration list to
        see the connection.
      operationId: StableIntegrationController_connect
      parameters:
        - name: integration
          required: true
          in: path
          schema:
            type: string
          x-vf-doc:
            description: The integration identifier, as `GET /v1/stable/integration` lists
              it (for example `twilio`).
          description: The integration identifier, as `GET /v1/stable/integration` lists
            it (for example `twilio`).
        - name: projectID
          required: true
          in: query
          schema:
            type: string
            description: The ID of the project to operate on.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/StableIntegrationConnectRequest"
      responses:
        "200":
          description: Confirms the credentials were stored. The body is a message only,
            so refetch the integration list to see `connected` flip for this
            integration.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/StableUpdateResponse"
          x-vf-doc:
            description: Confirms the credentials were stored. The body is a message only,
              so refetch the integration list to see `connected` flip for this
              integration.
      security:
        - token: []
components:
  schemas:
    StableIntegrationConnectRequest:
      oneOf:
        - type: object
          properties:
            integration:
              type: string
              enum:
                - eleven_labs
              x-enumNames:
                - ELEVEN_LABS
            credentials:
              type: string
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - twilio
              x-enumNames:
                - TWILIO
            credentials:
              $ref: "#/components/schemas/TwilioIntegrationAPIKeyValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - ujet
              x-enumNames:
                - UJET
            credentials:
              $ref: "#/components/schemas/UjetIntegrationCredentialsValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - genesys
              x-enumNames:
                - GENESYS
            credentials:
              $ref: "#/components/schemas/GenesysIntegrationCredentialsValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - kustomer
              x-enumNames:
                - KUSTOMER
            credentials:
              $ref: "#/components/schemas/KustomerIntegrationCredentialsValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - dixa
              x-enumNames:
                - DIXA
            credentials:
              $ref: "#/components/schemas/DixaIntegrationCredentialsValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - sunshine
              x-enumNames:
                - SUNSHINE
            credentials:
              $ref: "#/components/schemas/SunshineIntegrationCredentialsValue"
          required:
            - integration
            - credentials
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - zendesk
              x-enumNames:
                - ZENDESK
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - salesforce
              x-enumNames:
                - SALESFORCE
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - shopify
              x-enumNames:
                - SHOPIFY
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - google_sheets
              x-enumNames:
                - GOOGLE_SHEETS
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - google_gmail
              x-enumNames:
                - GOOGLE_GMAIL
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - airtable
              x-enumNames:
                - AIRTABLE
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - make
              x-enumNames:
                - MAKE
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - hubspot
              x-enumNames:
                - HUBSPOT
          required:
            - integration
          additionalProperties: false
        - type: object
          properties:
            integration:
              type: string
              enum:
                - example
              x-enumNames:
                - EXAMPLE
          required:
            - integration
          additionalProperties: false
    TwilioIntegrationAPIKeyValue:
      type: object
      properties:
        apiKeySid:
          type: string
          description: Sid associated with the API key.
        apiKeySecret:
          type: string
          description: Twilio API key secret value.
        accountSid:
          type: string
          description: Sid associated with the Twilio account.
      required:
        - apiKeySid
        - apiKeySecret
        - accountSid
    UjetIntegrationCredentialsValue:
      type: object
      properties:
        domain:
          type: string
          description: UJET domain.
        subdomain:
          type: string
          description: UJET subdomain.
        apiKey:
          type: string
          description: UJET API key.
        secretKey:
          type: string
          description: UJET secret key.
      required:
        - domain
        - subdomain
        - apiKey
        - secretKey
    GenesysIntegrationCredentialsValue:
      type: object
      properties:
        domain:
          type: string
          description: Genesys domain.
        clientId:
          type: string
          description: Genesys client ID.
        secretKey:
          type: string
          description: Genesys webhook secret.
        oauthSecretKey:
          type: string
          description: Genesys OAuth secret key.
      required:
        - domain
        - clientId
        - secretKey
        - oauthSecretKey
    KustomerIntegrationCredentialsValue:
      type: object
      properties:
        orgName:
          type: string
          description: Kustomer org slug
        apiKey:
          type: string
          description: Kustomer org-level Bearer API key.
        secretKey:
          type: string
          description: Kustomer outbound webhook signing secret.
      required:
        - orgName
        - apiKey
        - secretKey
    DixaIntegrationCredentialsValue:
      type: object
      properties:
        domain:
          description: Dixa domain.
          type: string
        apiKey:
          type: string
          description: Dixa API key.
        webhookSecretKey:
          type: string
          description: Dixa webhook secret key.
      required:
        - apiKey
        - webhookSecretKey
    SunshineIntegrationCredentialsValue:
      type: object
      properties:
        subdomain:
          type: string
          description: Zendesk subdomain, base of the Sunshine Conversations API.
        appId:
          type: string
          description: Sunshine Conversations app ID.
        keyId:
          type: string
          description: Sunshine API key ID, the Basic auth username.
        keySecret:
          type: string
          description: Sunshine API key secret, the Basic auth password.
        webhookSecret:
          type: string
          description: Sunshine webhook secret.
      required:
        - subdomain
        - appId
        - keyId
        - keySecret
        - webhookSecret
    StableUpdateResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable message confirming the update.
      required:
        - message
  securitySchemes:
    token:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Voiceflow bearer token
````
