---
title: "Attach Additional Contacts (Synchronous)"
url: "https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579/operations/attachAdditionalContacts"
---

> Full API specification: https://apipartners.mosaicinsurance.com/apis/trident-sandbox-1/versions/063565b3-7d5d-4ebb-9e4e-ea5966a41579.md

# Attach Additional Contacts (Synchronous)

`POST` `/submission/additionalContacts`

Operation ID: `attachAdditionalContacts`

Attaches one or more contacts to an existing policy activity. Supported role ids are 6 (ACC), 79 (OBG), 92 (BUY), 93 (SEL), 96 (REIND), and 98 (PEB). For a new contact, provide `companyName` and any known address details. To attach an existing contact, provide `additionalcontactid.id` with the role. Existing and new contacts can be supplied together in the same request. The response includes the XFI contact key for each attached contact in request order. ## Response timing Expected API response time is two minutes or less, subject to XFI availability and performance.

## Query parameters

- `policyId` (string, required) - XFI policy id (policyKey).
- `policyActivityId` (string, required) - XFI policy activity id (policyActivityKey).

## Header parameters

- `X-Origination-Source` (string, required) - Identifies the calling system or channel that originated this request. Used for traceability and auditing across the platform.
- `X-Audit-UserId` (string, required) - Identifier of the end user on whose behalf this request is made, recorded for audit trail purposes.

## Request body (required)

Content types: `application/json`

## Responses

- `200` - Contacts attached successfully.
- `400` - Invalid or empty contact request.
- `422` - Invalid contact details or XFI rejected the contacts.
- `500` - Unexpected error.

## OpenAPI definition

```yaml
openapi: 3.0.1
info:
  title: Mosaic APIs
  version: dev
servers:
  - url: https://apinonprod.mosaicinsurance.com
    description: Generated server url
paths:
  /submission/additionalContacts:
    post:
      security:
        - api_key: []
      tags:
        - Contacts
      summary: Attach Additional Contacts (Synchronous)
      description: >-
        Attaches one or more contacts to an existing policy activity. Supported
        role ids are 6 (ACC), 79 (OBG), 92 (BUY), 93 (SEL), 96 (REIND), and 98
        (PEB). For a new contact, provide `companyName` and any known address
        details. To attach an existing contact, provide `additionalcontactid.id`
        with the role. Existing and new contacts can be supplied together in the
        same request. The response includes the XFI contact key for each
        attached contact in request order.


        ## Response timing


        Expected API response time is two minutes or less, subject to XFI
        availability and performance.
      operationId: attachAdditionalContacts
      parameters:
        - $ref: "#/components/parameters/XOriginationSource"
        - $ref: "#/components/parameters/XAuditUserId"
        - name: policyId
          in: query
          description: XFI policy id (policyKey).
          required: true
          schema:
            type: string
          example: "1089712"
        - name: policyActivityId
          in: query
          description: XFI policy activity id (policyActivityKey).
          required: true
          schema:
            type: string
          example: "1144905"
      requestBody:
        description: A non-empty array of additional contacts. Each entry must include a
          role. For new contacts, provide companyName; for existing contacts,
          provide additionalcontactid.id. Both forms can be mixed in one
          request.
        required: true
        content:
          application/json:
            schema:
              type: array
              minItems: 1
              items:
                type: object
                required:
                  - role
                properties:
                  role:
                    type: object
                    required:
                      - id
                    properties:
                      id:
                        type: string
                        enum:
                          - "6"
                          - "79"
                          - "92"
                          - "93"
                          - "96"
                          - "98"
                        description: "Contact role: 6 (ACC), 79 (OBG), 92 (BUY), 93 (SEL), 96 (REIND),
                          or 98 (PEB)."
                  companyName:
                    type: string
                    description: Company name for a new contact.
                  domicileCountry:
                    type: object
                    properties:
                      code:
                        type: string
                        example: USA
                  domicileState:
                    type: object
                    properties:
                      code:
                        type: string
                        example: NY
                  mailingAddress1:
                    type: string
                  mailingAddressCity:
                    type: string
                  email:
                    type: string
                    format: email
                  zipCode:
                    type: string
                  additionalcontactid:
                    type: object
                    description: Lookup an existing XFI contact instead of creating a new one.
                    required:
                      - id
                    properties:
                      id:
                        type: string
                        example: "4044341"
            examples:
              Existing and New Contacts:
                summary: Attach an existing contact and a new contact
                value:
                  - role:
                      id: "6"
                    additionalcontactid:
                      id: "4044341"
                  - role:
                      id: "6"
                    companyName: Veritas Capital UAT Test 11
                    domicileCountry:
                      code: USA
                    domicileState:
                      code: NY
                    mailingAddress1: 1123 Cedar Street
                    mailingAddressCity: Green Bay
                    email: noemail@example.com
                    zipCode: "75039"
              New Contacts:
                summary: Attach two new contacts
                value:
                  - role:
                      id: "6"
                    companyName: Veritas Capital Test 89999
                    domicileCountry:
                      code: USA
                    domicileState:
                      code: NY
                    mailingAddress1: 1123 Cedar Street
                    mailingAddressCity: Green Bay
                    email: noemail@example.com
                    zipCode: "75039"
                  - role:
                      id: "6"
                    companyName: Veritas Capital Test 99966
                    domicileCountry:
                      code: USA
                    domicileState:
                      code: NY
                    mailingAddress1: 1123 Cedar Street
                    mailingAddressCity: Green Bay
                    email: noemail@example.com
                    zipCode: "75039"
      responses:
        "200":
          description: Contacts attached successfully.
          content:
            application/json:
              schema:
                type: object
                required:
                  - policyId
                  - policyActivityId
                  - attachedCount
                  - contacts
                properties:
                  policyId:
                    type: string
                  policyActivityId:
                    type: string
                  attachedCount:
                    type: integer
                  contacts:
                    type: array
                    items:
                      type: object
                      properties:
                        role:
                          type: object
                          properties:
                            id:
                              type: string
                        contactKey:
                          type: string
              example:
                policyId: "1089712"
                policyActivityId: "1144905"
                attachedCount: 2
                contacts:
                  - role:
                      id: "6"
                    contactKey: "4044280"
                  - role:
                      id: "6"
                    contactKey: "4044281"
        "400":
          description: Invalid or empty contact request.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "422":
          description: Invalid contact details or XFI rejected the contacts.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
        "500":
          description: Unexpected error.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ErrorResponse"
security:
  - api_key: []
components:
  parameters:
    XOriginationSource:
      name: X-Origination-Source
      in: header
      required: true
      description: Identifies the calling system or channel that originated this
        request. Used for traceability and auditing across the platform.
      schema:
        type: string
      example: S01x
    XAuditUserId:
      name: X-Audit-UserId
      in: header
      required: true
      description: Identifier of the end user on whose behalf this request is made,
        recorded for audit trail purposes.
      schema:
        type: string
      example: jsmith
  schemas:
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: "#/components/schemas/ErrorDetail"
    ErrorDetail:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
  securitySchemes:
    api_key:
      type: apiKey
      name: x-api-key
      in: header
```
