---
title: "Create a new company"
method: POST
path: "/people/2/companies"
tags: ["customer-engagement", "people", "company-profile"]
---

# Create a new company

`POST /people/2/companies`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/companies`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Use this method to create a new company.

## Request body

- F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fIamCompanyV2
  - `accountManager` string: Account manager.
  - `country` string: Country.
  - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `customAttributes` object: List of custom attributes for the company.
  - `customerStage` string: Customer stage.
  - `domains` string[]: List of domains for the company.
  - `externalId` string: Unique ID for a company from your or another external system, 256 characters max
  - `id` integer: Unique id of the entity.
  - `industry` string: Industry.
  - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `modifiedFrom` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
  - `name` string, required: Company name.
  - `notes` string: Notes.
  - `origin` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
  - `region` string: Region.
  - `segment` string: Segment.
  - `serviceData` object: Company's service information.
  - `tags` string[]: List of tags for the company.
  - `vatNumber` string: VAT number.

## Response `200`

successful response

- F1f4d23441e1a2e5d9e00e8bea59bdb50b3ee0c91558c0dac55f3a711b5f2d3fIamCompanyV2
  - `accountManager` string: Account manager.
  - `country` string: Country.
  - `createdAt` string: Date and time of creation. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `customAttributes` object: List of custom attributes for the company.
  - `customerStage` string: Customer stage.
  - `domains` string[]: List of domains for the company.
  - `externalId` string: Unique ID for a company from your or another external system, 256 characters max
  - `id` integer: Unique id of the entity.
  - `industry` string: Industry.
  - `modifiedAt` string: Date and time of last modification. Has the following format: yyyy-MM-dd'T'HH:mm:ss.
  - `modifiedFrom` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
  - `name` string, required: Company name.
  - `notes` string: Notes.
  - `origin` 'API' | 'PORTAL' | 'WEB_SDK' | 'INTEGRATION' | 'PUSH' | 'FACEBOOK' | 'LINE' | 'TELEGRAM' | 'SALESFORCE' | 'DYNAMICS' | 'ZAPIER' | 'FORMS' | 'COMPUTED' | 'ANSWERS' | 'CONVERSATIONS'
  - `region` string: Region.
  - `segment` string: Segment.
  - `serviceData` object: Company's service information.
  - `tags` string[]: List of tags for the company.
  - `vatNumber` string: VAT number.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)