> For the complete documentation index, see [llms.txt](https://docs.fstrk.io/knowledge_base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fstrk.io/knowledge_base/intagrations/hubspot/methods.md).

# Hubspot: Процедуры

## Hubspot: Процедуры для настройки сценариев

***

* [Контакты](#kontakty)
  * [Новый контакт](#novyi-kontakt)
  * [Поиск контакта](#poisk-kontakta)
  * [Изменение контакта](#izmenenie-kontakta)
  * [Заметка для контакта](#zametka-dlya-kontakta)
* [Сделки](#sdelki)
  * [Новая сделка](#novaya-sdelka)
  * [Список сделок](#spisok-sdelok)
  * [Поиск сделки](#poisk-sdelki)
  * [Изменение сделки](#izmenenie-sdelki)
  * [Заметка для сделки](#zametka-dlya-sdelki)
* [Задачи](#zadachi)
  * [Новая задача](#novaya-zadacha)
  * [Поиск задачи](#poisk-zadachi)
  * [Изменение задачи](#izmenenie-zadachi)

***

## Контакты

Процедуры для работы с контактами в Hubspot.

### Новый контакт

Создать контакт в Hubspot.

```
{% hubspot.create_contact phone_number=<телефон> <поля контакта> as contact %}
```

* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона

Дополнительные поля:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `email` *(str)* – Адрес электронной почты
* `custom_fields` *(dict)* – Дополнительные поля

### Поиск контакта

Получить информацию о контакте в Hubspot.

```
{% hubspot.get_contact <id> <параметры> as contact %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона
* `email` *(str)* <mark style="color:red;">\*</mark> – Адрес электронной почты&#x20;

Дополнительные параметры:

* `in_fields` *(list)* – Кастомные поля

\[ ⚠️ ] Ограничения:

* Используйте только один из идентификаторов: `uid`, `phone_number` или `email`
* Допускается не больше 4х значений для `in_fields`

### Изменение контакта

Редактировать информацию о контакте в Hubspot по его id, телефону или почте.

#### Редактировать контакт по ID

```
{% hubspot.edit_contact_by_id uid=<id контакта> <поля контакта> as contact %}
```

* `uid` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `phone_number` *(str)* – Номер телефона
* `email` *(str)* – Адрес электронной почты&#x20;
* `custom_fields` *(dict)* – Дополнительные поля

#### Редактировать контакт по номеру телефона

```
{% hubspot.edit_contact_by_phone_number phone_nuber=<телефон> <поля контакта> as contact %}
```

* `phone_number` *(str)* <mark style="color:red;">\*</mark> – Номер телефона

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `email` *(str)* – Адрес электронной почты&#x20;
* `custom_fields` *(dict)* – Дополнительные поля

#### Редактировать контакт по адресу эл. почты

```
{% hubspot.edit_contact_by_email email=<почта> <поля контакта> as contact %}
```

* `email` *(str)* <mark style="color:red;">\*</mark> – Адрес электронной почты&#x20;

Поля для редактирования:

* `first_name` *(str)* – Имя
* `last_name` *(str)* – Фамилия
* `phone_number` *(str)* – Номер телефона
* `custom_fields` *(dict)* – Дополнительные поля

### Заметка для контакта

Создать заметку для контакта в Hubspot.

```
{% hubspot.create_note contact_id=<id контакта> body=<содержание заметки> as note %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `body` *(str)* <mark style="color:red;">\*</mark> – Содержание заметки

## Сделки

Процедуры для работы со сделками в Hubspot.

### Новая сделка

Создать сделку в Hubspot.

```
{% hubspot.create_deal name=<название> <поля сделки> as deal %}
```

* `name` *(str)* <mark style="color:red;">\*</mark> – Название для сделки

Поля сделки:

* `pipline` *(str)* – Воронка для сделки
* `dealstage` *(str)* – Этап сделки
* `contact_id` *(str)* – Идентификатор контакта
* `custom_fields` *(dict)* – Дополнительные поля

### Список сделок

Получить список сделко, связанных с контактом в Hubspot.

```
{% hubspot.get_deals contact_id=<id контакта> limit=100 <параметры> as deals %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `limit` *(int)* <mark style="color:red;">\*</mark> – Кол-во сделок в ответе (по умолчанию 100, максимально 100)

Дополнительные параметры:

* `exclude_status_ids` *(list)* – Идентификаторы этапов
* `exclude_pipeline_ids` *(list)* – Идентификаторы воронок

### Поиск сделки

Получить информацию о сделке в Hubspot.

```
{% hubspot.get_deal deal_id=<id сделки> as deal %}
```

* `deal_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор сделки

### Изменение сделки

Редактировать информацию о сделке в Hubspot.

```
{% hubspot.edit_deal deal_id=<id сделки> <поля сделки> as deal %}
```

* `deal_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор сделки

Поля для редактирования:

* `name` *(str)* – Название для сделки
* `pipline` *(str)* – Воронка для сделки
* `dealstage` *(str)* – Этап сделки
* `custom_fields` *(dict)* – Дополнительные поля

### Заметка для сделки

Создать заметку для сделки в Hubspot.

```
{% hubspot.create_note deal_id=<id сделки> body=<содержание заметки> as note %}
```

`deal_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор сделки

`body` *(str)* <mark style="color:red;">\*</mark> – Содержание заметки

## Задачи

Процедуры для работы с задачами в Hubspot.

### Новая задача

Создать задачу можно для сделки или для контакта в Hubspot.

#### Создать задачу для контакта

```
{% hubspot.create_task contact_id=<id контакта> body=<задача> due_at=<срок> <поля задачи> as task %}
```

* `contact_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор контакта
* `body` *(str)* <mark style="color:red;">\*</mark> – Содержание задачи
* `due_at` *(datetime)* <mark style="color:red;">\*</mark> – Срок

Дополнительные поля:

* `subject` *(str)* – Тема для задачи

#### Создать зачачу для сделки

```
{% hubspot.create_task deal_id=<id cделки> body=<задача> due_at=<срок> <поля задачи> as task %}
```

* `deal_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор сделки
* `body` *(str)* <mark style="color:red;">\*</mark> – Содержание задачи
* `due_at` *(datetime)* <mark style="color:red;">\*</mark> – Срок

Дополнительные поля:

* `subject` *(str)* – Тема для задачи

### Поиск задачи

Получить информацию о задаче в Hubspot.

```
{% hubspot.get_task task_id=<id задачи> as task %}
```

* `task_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор задачи

### Изменение задачи

Редактировать информацию о задаче в Hubspot.

```
{% hubspot_edit_task task_id=<id задачи> <поля задачи> as task %}
```

* `task_id` *(int)* <mark style="color:red;">\*</mark> – Идентификатор задачи

Поля для редактирования:

* `subject` *(str)* – Тема для задачи
* `body` *(str)* – Содержание задачи


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.fstrk.io/knowledge_base/intagrations/hubspot/methods.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.