---
title: "Merge contacts"
method: POST
path: "/v1/companies/merge"
tags: ["Company"]
---

# Merge contacts

`POST /v1/companies/merge`

## Request

- Base URL: `https://api.infoset.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infoset.app/v1/companies/merge`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`
- TypeScript: <https://skmtc.dev/infoset/apis/infoset-rest-api/docs/v1/companies/merge/post.ts> (a function with typed inputs; its response is checked against the schema)

## Request body

- CompanyMergeRequestModel
  - `ids` integer[], required
  - `newCompany` unknown, required

## Response `201`

Created

- Company
  - `id` integer
  - `departmentId` integer
  - `name` string, required
  - `code` string, nullable
  - `email` string, nullable
  - `phone` string, nullable: Phone number of the company, with country code, without leading + (plus) sign
  - `web` string, nullable: Website domain of the company
  - `countryCode` string, nullable: ISO Alpha-2 country code, see <a href="https://www.iban.com/country-codes">https://www.iban.com/country-codes</a>
  - `state` string, nullable
  - `city` string, nullable
  - `town` string, nullable
  - `zip` string, nullable
  - `address` string, nullable
  - `createdUserId` integer
  - `createdDate` string, date-time, nullable
  - `updatedUserId` integer
  - `updatedDate` string, date-time, nullable
  - `customFields` string, nullable: A stringified JSON object mapping custom field names to values Example: {"My Text Custom Field":"Field Value","My Numeric Custom Field":2}
  - `photoUrl` string, nullable: Company logo URL

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/infoset/apis/infoset-rest-api.md) - [All operations](https://skmtc.dev/infoset/apis/infoset-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/infoset/apis/infoset-rest-api/revisions/709c8123f593?raw)