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

# Confirm quick link

> Records consent, applies the chat-history choice, assigns Customer ownership when applicable, and returns the redirect target.



## OpenAPI

````yaml api-reference/features/integrations.json POST /quicklink/{token}/confirm
openapi: 3.0.3
info:
  title: Integrations API methods
  version: 1.0.0
  description: >-
    Task-focused integrations methods across supported Polymorfa connection
    types.
servers: []
security: []
paths:
  /quicklink/{token}/confirm:
    post:
      tags:
        - Quicklink
      summary: Confirm quick link
      description: >-
        Records consent, applies the chat-history choice, assigns Customer
        ownership when applicable, and returns the redirect target.
      operationId: nativeConfirmQuickLink
      parameters:
        - schema:
            type: string
            description: Opaque QuickLink token from the hosted URL.
          required: true
          name: token
          in: path
          description: Opaque token required by the target operation.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/native__QuickLinkConfirmRequest'
      responses:
        '200':
          description: Connected
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      status:
                        type: string
                        enum:
                          - connected
                        description: |-
                          Current status of this resource or operation.

                          <!-- polymorfa-input-table -->
                          **Allowed values**
                          | Value | Meaning |
                          | --- | --- |
                          | `connected` | Connected. |
                      phone:
                        type: string
                        nullable: true
                        description: |-
                          Phone number in international format.

                          <!-- polymorfa-input-table -->
                          **Accepted alternatives**
                          | Alternative | Accepted input |
                          | --- | --- |
                          | Alternative 1 | Type: `string` |
                          | Alternative 2 | `null` |
                      historySync:
                        type: boolean
                        description: >-
                          History synchronization behavior for newly connected
                          sessions.
                      redirectUrl:
                        type: string
                        nullable: true
                        description: |-
                          URL for the redirect.

                          <!-- polymorfa-input-table -->
                          **Accepted alternatives**
                          | Alternative | Accepted input |
                          | --- | --- |
                          | Alternative 1 | Type: `string` |
                          | Alternative 2 | `null` |
                    required:
                      - status
                      - phone
                      - historySync
                      - redirectUrl
                    description: Structured data carried by this object.
                required:
                  - data
        '400':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '403':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '404':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '409':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '422':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '429':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '500':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
        '503':
          description: QuickLink request failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/native__PublicQuickLinkError'
      security: []
      servers:
        - url: https://api.polymorfa.com
components:
  schemas:
    native__QuickLinkConfirmRequest:
      type: object
      properties:
        historySync:
          type: boolean
          description: History synchronization behavior for newly connected sessions.
    native__PublicQuickLinkError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              description: Stable machine-readable code for this result.
            message:
              type: string
              description: Human-readable message associated with this result.
          required:
            - code
            - message
          description: Error details returned when the operation fails.
        data:
          type: object
          properties:
            candidates:
              type: array
              items:
                type: object
                properties:
                  phone:
                    type: string
                    description: Phone number in international format.
                  whatsappPhone:
                    type: string
                    description: Specifies whatsapp phone for this candidate.
                  registered:
                    type: boolean
                    nullable: true
                    description: >-
                      Whether WhatsApp registration was confirmed. Null means
                      the result is unknown.


                      <!-- polymorfa-input-table -->

                      **Accepted alternatives**

                      | Alternative | Accepted input |

                      | --- | --- |

                      | Alternative 1 | Type: `boolean` |

                      | Alternative 2 | `null` |
                  pushName:
                    type: string
                    nullable: true
                    description: |-
                      WhatsApp display name reported by the sender's client.

                      <!-- polymorfa-input-table -->
                      **Accepted alternatives**
                      | Alternative | Accepted input |
                      | --- | --- |
                      | Alternative 1 | Type: `string` |
                      | Alternative 2 | `null` |
                  pictureUrl:
                    type: string
                    nullable: true
                    description: |-
                      URL for the picture.

                      <!-- polymorfa-input-table -->
                      **Accepted alternatives**
                      | Alternative | Accepted input |
                      | --- | --- |
                      | Alternative 1 | Type: `string` |
                      | Alternative 2 | `null` |
                  accountType:
                    type: string
                    enum:
                      - whatsapp
                      - business_app
                      - cloud_api
                      - coexistence
                      - unknown
                      - unregistered
                    description: |-
                      Category assigned to account.

                      <!-- polymorfa-input-table -->
                      **Allowed values**
                      | Value | Meaning |
                      | --- | --- |
                      | `whatsapp` | Whatsapp. |
                      | `business_app` | Business app. |
                      | `cloud_api` | Cloud api. |
                      | `coexistence` | Coexistence. |
                      | `unknown` | Unknown. |
                      | `unregistered` | Unregistered. |
                required:
                  - phone
                  - registered
                  - pushName
                  - pictureUrl
              description: Candidates associated with this data.
          required:
            - candidates
          description: Structured data carried by this object.
      required:
        - error

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.