# Добавление
## Добавление нового контрагента
`POST` `https://do.myfreshcloud.com/company/insert`
#### Request Body
| Name | Type | Description |
| ----------------------------------------- | ---- | ----------- |
| company\* | JSON | |
{% tabs %}
{% tab title="200: OK Стандартный объект ответа" %}
```javascript
{
"status": "success",
"error": null,
"code": "0",
"rows": 1,
"pages": 1,
"page": 1,
"value": "1"
}
```
{% endtab %}
{% endtabs %}
## JSON
Все доступные параметры нового объекта
* **name** - \* Наименование компании
* **first\_name** - Имя физического лица
* **last\_name** - Фамилия физического лица
* **middle\_name** - Отчество физического лица
* **person** - Признак юридическое или физическое лицо \[Int] (1/2)
* **address** - Основной адрес
* **country** - Страна
* **region** - Регион
* **user\_id** - \* Код ответственного
* **type\_id** - \* Код типа
* **status\_id** - Код статуса
* **category\_id** - Код категории
* **url** - Вэб сайт
* **activity\_type** - Род деятельности
* **info\_source** - Источник информации
* **note** - Примечание
* **which\_site\_source -** Web сайт источник лида
* **which\_host\_source -** Web хост источник лида
* **which\_link\_source -** Web ссылка перехода источник лида
* **utm\_campaign -** UTM источник лида
* **utm\_source -** UTM источник лида
* **utm\_medium -** UTM источник лида
* **utm\_content -** UTM источник лида
* **utm\_term -** UTM источник лида
#### Contacts - Список контактных лиц
* **first\_name** - Имя
* **last\_name** - Фамилия
* **post -** Должность
* **note** - Примечание
* **status\_id** - Код статуса контактного лица
* **Email -** Список emal адресов контактного лица
* **Phones** - Список телефонов контактного лица
#### Emails - Список email адресов контрагента
* **email** - Email
#### Phones - Список телефонов контрагента
* **phone** - Телефон
* **descr** - Тип телефона
```
{
"name" : "Apple",
"type_id" : 1,
"user_id" : 37,
"Contacts": [
{
"first_name": "John",
"last_name": "Smith",
"post": "CEO",
"note": "The main decision maker",
"status_id": 1,
"Emails": [
{
"email": "John@example.com"
}
],
"Phones": [
{
"phone": "+1 234 567890",
"descr": "mobile"
}
]
}
],
"Emails": [
{
"email": "company@example.com"
}
],
"Phones": [
{
"phone": "+1 123 345678",
"descr": "Reception"
}
]
}
```
{% hint style="info" %}
**Обязательные параметры**\
name (Наименование)\
type\_id (Код типа контрагента, можно взять в справчнике)\
user\_id (Код отвесвенного, можно взять пользователях)
{% endhint %}
## Пример
{% tabs %}
{% tab title="cURL" %}
```
curl --location --request POST 'https://do.myfreshcloud.com/company/insert' \
--header 'Authorization: Bearer XXXX-XXXXXXX-XXXXXXX' \
--header 'Content-Type: application/json' \
--data-raw '{
"name" : "Apple",
"type_id" : 1,
"user_id" : 37,
"Contacts": [
{
"first_name": "John",
"last_name": "Smith",
"post": "CEO",
"note": "The main decision maker",
"status_id": 1,
"Emails": [
{
"email": "John@example.com"
}
],
"Phones": [
{
"phone": "+1 234 567890",
"descr": "mobile"
}
]
}
],
"Emails": [
{
"email": "company@example.com"
}
],
"Phones": [
{
"phone": "+1 123 345678",
"descr": "Reception"
}
]
}
'
```
{% endtab %}
{% tab title="PHP" %}
```
'https://do.myfreshcloud.com/company/insert',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'POST',
CURLOPT_POSTFIELDS =>'{
"name" : "Apple",
"type_id" : 1,
"user_id" : 37,
"Contacts": [
{
"first_name": "John",
"last_name": "Smith",
"post": "CEO",
"note": "The main decision maker",
"status_id": 1,
"Emails": [
{
"email": "John@example.com"
}
],
"Phones": [
{
"phone": "+1 234 567890",
"descr": "mobile"
}
]
}
],
"Emails": [
{
"email": "company@example.com"
}
],
"Phones": [
{
"phone": "+1 123 345678",
"descr": "Reception"
}
]
}
',
CURLOPT_HTTPHEADER => array(
'Authorization: Bearer XXXXX-XXXXXXX-XXXXXXXXX',
'Content-Type: application/json'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;
```
{% endtab %}
{% tab title="NodeJS (Request)" %}
```
var request = require('request');
var options = {
'method': 'POST',
'url': 'https://do.myfreshcloud.com/company/insert',
'headers': {
'Authorization': 'Bearer XXXX-XXXXXXX-XXXXXXX',
'Content-Type': 'application/json'
},
body: JSON.stringify({
"name": "Apple",
"type_id": 1,
"user_id": 37,
"Contacts": [
{
"first_name": "John",
"last_name": "Smith",
"post": "CEO",
"note": "The main decision maker",
"status_id": 1,
"Emails": [
{
"email": "John@example.com"
}
],
"Phones": [
{
"phone": "+1 234 567890",
"descr": "mobile"
}
]
}
],
"Emails": [
{
"email": "company@example.com"
}
],
"Phones": [
{
"phone": "+1 123 345678",
"descr": "Reception"
}
]
})
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});
```
{% endtab %}
{% endtabs %}
## Справочники
{% content-ref url="../directory/directories-company" %}
[directories-company](https://apidoc.myfreshcloud.com/reference/directory/directories-company)
{% endcontent-ref %}
{% content-ref url="../users" %}
[users](https://apidoc.myfreshcloud.com/reference/users)
{% endcontent-ref %}
## Ответ
```
{
"status": "success",
"error": null,
"code": "0",
"rows": 1,
"pages": 1,
"page": 1,
"value": "1"
}
// value - ID идентификатор нового контрагента
```