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

# Create Identity Setup Link



## OpenAPI

````yaml /api-reference/customer-api.v1.openapi.json post /v1/admin/identity-setup-link
openapi: 3.1.0
info:
  title: Mount Thor Customer API
  version: v1
servers:
  - description: Mount Thor customer API edge
    url: https://api.mountthor.com
security: []
paths:
  /v1/admin/identity-setup-link:
    post:
      tags:
        - identity
      summary: Create Identity Setup Link
      operationId: issue_customer_admin_identity_setup_link
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/IssueCustomerAdminIdentitySetupLinkRequest'
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/IssueCustomerAdminIdentitySetupLinkResponse
          description: Setup link minted
        '400':
          description: Request body failed validation
        '401':
          description: Missing or invalid customer credential
        '403':
          description: Credential is missing users:write scope
        '404':
          description: No eligible identity integration for this customer
        '429':
          content:
            text/plain:
              schema:
                type: string
          description: Rate limit exceeded
          headers:
            Retry-After:
              description: Seconds before retry.
              schema:
                minimum: 1
                type: integer
        '503':
          description: Service unavailable
      security:
        - api_key_bearer:
            - users:write
components:
  schemas:
    IssueCustomerAdminIdentitySetupLinkRequest:
      additionalProperties: false
      properties:
        intent:
          example: sso
          type:
            - string
            - 'null'
        reason:
          description: |-
            Optional audit reason (8..=1000 chars when present). The portal
            can send a short context string like "customer admin clicked
            Setup SSO Logins". When omitted, the audit row records a
            stock reason naming the actor type.
          example: customer admin clicked Setup SSO Logins
          type:
            - string
            - 'null'
        return_url:
          deprecated: true
          example: https://api.mountthor.com/identity/setup-completed
          type:
            - string
            - 'null'
      type: object
    IssueCustomerAdminIdentitySetupLinkResponse:
      additionalProperties: false
      properties:
        expires_at:
          type: string
        identity_integration_id:
          description: UUID of the underlying identity integration the link is scoped to.
          format: uuid
          type: string
        intent:
          description: Echoed intent (`sso`, `dsync`, `domain_verification`).
          example: sso
          type: string
        provider:
          example: workos
          type: string
        url:
          type: string
      required:
        - identity_integration_id
        - provider
        - intent
        - url
        - expires_at
      type: object
  securitySchemes:
    api_key_bearer:
      bearerFormat: mthr_live_*
      description: Bearer scheme name used by typed customer admin operations.
      scheme: bearer
      type: http

````