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

# Link identifiers to a person

> Attaches an email, phone or LinkedIn URL to an existing person, so later messages from that address are matched to them. Empty fields on the record may be filled from what you send.




## OpenAPI

````yaml /openapi/records.yaml post /people/{id}/link-identifiers
openapi: 3.1.0
info:
  title: Connie Records API
  version: 1.0.0
  description: >
    Endpoints the Connie web app uses for records. They authenticate with your
    signed-in browser session — see
    https://docs.connie.ai/api-reference/authentication. These are the app's own
    endpoints and can change when the app changes.
servers:
  - url: https://connie.ai/api
security:
  - sessionCookie: []
tags:
  - name: Lists
    description: Lists of records on an object, and the records in them.
  - name: People
    description: Find, match and create records on the People object.
  - name: Companies
    description: Find and create records on the Companies object.
  - name: Notes
    description: Notes on a person.
  - name: Tasks
    description: Tasks linked to a person or a company, and their comments.
paths:
  /people/{id}/link-identifiers:
    post:
      tags:
        - People
      summary: Link identifiers to a person
      description: >
        Attaches an email, phone or LinkedIn URL to an existing person, so later
        messages from that address are matched to them. Empty fields on the
        record may be filled from what you send.
      operationId: linkPersonIdentifiers
      parameters:
        - $ref: '#/components/parameters/PersonId'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - workspaceId
              properties:
                workspaceId:
                  type: string
                  format: uuid
                  description: Must be the person's workspace.
                email:
                  type:
                    - string
                    - 'null'
                phone:
                  type:
                    - string
                    - 'null'
                linkedinUrl:
                  type:
                    - string
                    - 'null'
                name:
                  type:
                    - string
                    - 'null'
                avatarUrl:
                  type:
                    - string
                    - 'null'
      responses:
        '200':
          description: Identifiers linked.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  linkedCount:
                    type: integer
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    PersonId:
      name: id
      in: path
      required: true
      description: The person's record id.
      schema:
        type: string
        format: uuid
  responses:
    BadRequest:
      description: A required field is missing or invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: >-
        No valid session (`UNAUTHORIZED`), or the session has expired
        (`SESSION_EXPIRED`).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: You aren't a member of the workspace or don't have access to this item.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: Not found.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
          description: Human-readable message.
        code:
          type: string
          description: Machine-readable code, when there is one.
      required:
        - error
  securitySchemes:
    sessionCookie:
      type: apiKey
      in: header
      name: Cookie
      description: >-
        The full Cookie header copied from a signed-in connie.ai browser
        request. See the Authentication page.

````

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