---
title: "Generates a new Merge Document"
method: POST
path: "/Contacts/{id}/MergeDocument/{documentTemplateId}"
tags: ["Contacts"]
---

# Generates a new Merge Document

`POST /Contacts/{id}/MergeDocument/{documentTemplateId}`

## Request

- Base URL: `https://api.insightly.com/v3.1`
- URL: `https://api.insightly.com/v3.1/Contacts/{id}/MergeDocument/{documentTemplateId}`
- Auth: none declared. Required headers: `Authorization`

Returns the generated document. If the 'format' parameter is set to 'JSON', returns the metadata of the associated File Attachment in JSON format.

## Path parameters

- `id` integer, required
- `documentTemplateId` integer, required

## Query parameters

- `format` string

## Headers

- `Authorization` string, required

## Response `200`

Request succeeded.

- object[]
  - `CONTACT_ID` integer
  - `SALUTATION` string, string
  - `FIRST_NAME` string, string, required
  - `LAST_NAME` string, string
  - `IMAGE_URL` string, string
  - `BACKGROUND` string, string
  - `OWNER_USER_ID` integer
  - `DATE_CREATED_UTC` string, date-time
  - `DATE_UPDATED_UTC` string, date-time
  - `SOCIAL_LINKEDIN` string, string
  - `SOCIAL_FACEBOOK` string, string
  - `SOCIAL_TWITTER` string, string
  - `DATE_OF_BIRTH` string, date-time
  - `PHONE` string, string
  - `PHONE_HOME` string, string
  - `PHONE_MOBILE` string, string
  - `PHONE_OTHER` string, string
  - `PHONE_ASSISTANT` string, string
  - `PHONE_FAX` string, string
  - `EMAIL_ADDRESS` string, string
  - `ASSISTANT_NAME` string, string
  - `ADDRESS_MAIL_STREET` string, string
  - `ADDRESS_MAIL_CITY` string, string
  - `ADDRESS_MAIL_STATE` string, string
  - `ADDRESS_MAIL_POSTCODE` string, string
  - `ADDRESS_MAIL_COUNTRY` string, string
  - `ADDRESS_OTHER_STREET` string, string
  - `ADDRESS_OTHER_CITY` string, string
  - `ADDRESS_OTHER_STATE` string, string
  - `ADDRESS_OTHER_POSTCODE` string, string
  - `ADDRESS_OTHER_COUNTRY` string, string
  - `LAST_ACTIVITY_DATE_UTC` string, date-time
  - `NEXT_ACTIVITY_DATE_UTC` string, date-time
  - `CREATED_USER_ID` integer
  - `ORGANISATION_ID` integer
  - `TITLE` string, string
  - `EMAIL_OPTED_OUT` boolean
  - `CUSTOMFIELDS` APICustomField[]
    - `FIELD_NAME` string
    - `FIELD_VALUE` object
  - `TAGS` APITag[]
    - `TAG_NAME` string
  - `DATES` APIDate[]
    - `DATE_ID` integer
    - `OCCASION_NAME` string
    - `OCCASION_DATE` string, date-time
    - `REPEAT_YEARLY` boolean
    - `CREATE_TASK_YEARLY` boolean
  - `LINKS` APILinkDto[]
    - `LINK_ID` integer
    - `OBJECT_NAME` string
    - `OBJECT_ID` integer
    - `LINK_OBJECT_NAME` string
    - `LINK_OBJECT_ID` integer
    - `ROLE` string
    - `DETAILS` string
    - `RELATIONSHIP_ID` integer
    - `IS_FORWARD` boolean

## Other responses

- `400`: Often missing or invalid parameter.
- `401`: Authentication failed.
- `403`: API User does not have access to Document Template.
- `404`: Record not found.

---

[API](https://skmtc.dev/insightly/apis/insightly-api-v3-1.md) - [All operations](https://skmtc.dev/insightly/apis/insightly-api-v3-1/llms.txt) - [OpenAPI document](https://skmtc.dev/insightly/apis/insightly-api-v3-1/revisions/e7df0c3b65fb?raw)