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

# Link a social account to the user

> Link a social account to the user



## OpenAPI

````yaml /api/openapi.json post /api/auth/link-social
openapi: 3.1.0
info:
  title: Aquila API
  version: 1.0.0
  description: >-
    Event-driven reconnaissance platform API. All /api/* routes except
    /api/public/* require an authenticated session (cookie), an X-Api-Key
    header, or a bearer token. Auth endpoints under /api/auth/* are generated by
    Better Auth.
servers:
  - url: https://aquila.attaxr.com
  - url: http://localhost
security: []
tags:
  - name: AI
  - name: Agents
  - name: Bulk Delete
  - name: Chat
  - name: Constraints
  - name: Dashboard
  - name: Events
  - name: JS
  - name: JS Analysis
  - name: JS Monitoring
  - name: Leads
  - name: MCP Key
  - name: Models
  - name: Notification Channels
  - name: Notification Event Preferences
  - name: Notifications
  - name: OOB
  - name: Provider Keys
  - name: Public Shares
  - name: Reinforcements
  - name: Reports
  - name: Scans
  - name: Schedules
  - name: Shares
  - name: Tools
  - name: User Profiles
  - name: V1
  - name: Vulnerabilities
  - name: Workflows
paths:
  /api/auth/link-social:
    post:
      tags:
        - Auth
      summary: Link a social account to the user
      description: Link a social account to the user
      operationId: linkSocialAccount
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                callbackURL:
                  type: string
                  description: The URL to redirect to after the user has signed in
                provider:
                  anyOf:
                    - type: string
                      enum:
                        - apple
                        - atlassian
                        - cognito
                        - discord
                        - facebook
                        - figma
                        - github
                        - microsoft
                        - google
                        - huggingface
                        - slack
                        - spotify
                        - twitch
                        - twitter
                        - dropbox
                        - kick
                        - linear
                        - linkedin
                        - gitlab
                        - tiktok
                        - reddit
                        - roblox
                        - salesforce
                        - vk
                        - zoom
                        - notion
                        - kakao
                        - naver
                        - line
                        - paybin
                        - paypal
                        - polar
                        - railway
                        - vercel
                        - wechat
                    - type: string
                idToken:
                  type: object
                  properties:
                    token:
                      type: string
                    nonce:
                      type: string
                    accessToken:
                      type: string
                    refreshToken:
                      type: string
                    scopes:
                      type: array
                      items:
                        type: string
                  required:
                    - token
                requestSignUp:
                  type: boolean
                scopes:
                  type: array
                  items:
                    type: string
                  description: Additional scopes to request from the provider
                errorCallbackURL:
                  type: string
                  description: >-
                    The URL to redirect to if there is an error during the link
                    process
                disableRedirect:
                  type: boolean
                  description: >-
                    Disable automatic redirection to the provider. Useful for
                    handling the redirection yourself
                additionalData:
                  type: object
                  propertyNames:
                    type: string
                  additionalProperties: {}
              required:
                - provider
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  url:
                    type: string
                    description: The authorization URL to redirect the user to
                  redirect:
                    type: boolean
                    description: >-
                      Indicates if the user should be redirected to the
                      authorization URL
                  status:
                    type: boolean
                required:
                  - redirect
        '400':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
          description: >-
            Bad Request. Usually due to missing parameters, or invalid
            parameters.
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
          description: Unauthorized. Due to missing or invalid authentication.
        '403':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
          description: >-
            Forbidden. You do not have permission to access this resource or to
            perform this action.
        '404':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
          description: Not Found. The requested resource was not found.
        '429':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
          description: >-
            Too Many Requests. You have exceeded the rate limit. Try again
            later.
        '500':
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
          description: >-
            Internal Server Error. This is a problem with the server that you
            cannot fix.
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal API key sent as a bearer token.

````