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

# Create Connection

> Creates a new external SSO connection for the organization. Calls the `POST /sdk/v1/b2b/sso/external` endpoint. Requires an active session.

## Parameters

<ParamField body="externalConnectionId" type="String" required />

<ParamField body="externalOrganizationId" type="String" required />

<ParamField body="displayName" type="String?" />

## Returns

<ResponseField name="requestId" type="String" required />

<ResponseField name="statusCode" type="Int" required />

<ResponseField name="connection" type="ApiSsoV1ExternalConnection?">
  <Expandable title="properties">
    <ResponseField name="organizationId" type="String" required />

    <ResponseField name="connectionId" type="String" required />

    <ResponseField name="externalOrganizationId" type="String" required />

    <ResponseField name="externalConnectionId" type="String" required />

    <ResponseField name="displayName" type="String" required />

    <ResponseField name="status" type="String" required />

    <ResponseField name="externalConnectionImplicitRoleAssignments" type="List<ApiSsoV1ExternalConnectionImplicitRoleAssignment>" required>
      <Expandable title="properties">
        <ResponseField name="roleId" type="String" required />
      </Expandable>
    </ResponseField>

    <ResponseField name="externalGroupImplicitRoleAssignments" type="List<ApiSsoV1ExternalGroupImplicitRoleAssignment>" required>
      <Expandable title="properties">
        <ResponseField name="roleId" type="String" required />

        <ResponseField name="group" type="String" required />
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```kotlin theme={null}
  StytchB2B.sso.external.createConnection(
      B2BCreateExternalConnectionParameters(
          externalConnectionId = "ext-conn-test-d5a3b680-e8a3-40c0-b815-ab79986666d0",
          externalOrganizationId = "ext-org-test-d5a3b680-e8a3-40c0-b815-ab79986666d0",
      )
  )
  ```
</RequestExample>