# Добавление
## Добавление нового контрагента
`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="/pages/p3ibECb5nmfHj0yEUSon" %}
[Для контрагентов](/reference/directory/directories-company.md)
{% endcontent-ref %}
{% content-ref url="/pages/AZqUPlTdpl1jAyZMvODJ" %}
[Пользователи](/reference/users.md)
{% endcontent-ref %}
## Ответ
```
{
"status": "success",
"error": null,
"code": "0",
"rows": 1,
"pages": 1,
"page": 1,
"value": "1"
}
// value - ID идентификатор нового контрагента
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://apidoc.myfreshcloud.com/reference/company/add_company.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.