{"name":"Мегаплан API v3","vendor":"Мегаплан","industry":"crm","summary":"REST API системы управления задачами, проектами и сделками Мегаплан: задачи, проекты, сделки и схемы сделок, клиенты (компании и люди), сотрудники, комментарии, файлы. Запросы выполняются к адресу конкретного аккаунта с префиксом `/api/v3/`. Все сущности — JSON-объекты с полем `contentType`, а ссылки на другие сущности передаются «ссылочными» объектами из `contentType` и `id`.","docsUrl":"https://dev.megaplan.ru/apiv3/index.html","coverage":{"included":[],"excluded":[]},"scenarios":[{"id":"postavit-zadachu-sotrudniku","title":"Поставить задачу сотруднику","summary":"Создавать задачи в Мегаплане из своей системы: заявка с сайта, обращение в поддержку, напоминание.","steps":["Получи токен: POST /api/v3/auth/access_token с username, password и grant_type = password (multipart-форма). Токен живёт 48 часов — сохрани его и обновляй заранее. Передавай в заголовке AUTHORIZATION: Bearer <token>.","Найди ответственного: GET /api/v3/employee — в ответе id сотрудников.","Создай задачу: POST /api/v3/task с contentType = Task, name и responsible — ссылочным объектом {\"contentType\": \"Employee\", \"id\": ...}. Описание — subject, срочность — isUrgent.","Ответ приходит в конверте meta + data: id новой задачи — в data.id, ошибки — в meta.","Чтобы поменять задачу, отправь POST /api/v3/task/{id} с изменяемыми полями — Мегаплан меняет сущности POST-запросом на их адрес, а не PUT или PATCH."],"code":"TOKEN=$(curl -s -X POST https://<аккаунт>.megaplan.ru/api/v3/auth/access_token \\\n  -F username=<логин> -F password=<пароль> -F grant_type=password | jq -r .access_token)\n\ncurl -X POST https://<аккаунт>.megaplan.ru/api/v3/task \\\n  -H \"AUTHORIZATION: Bearer $TOKEN\" \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n        \"contentType\": \"Task\",\n        \"name\": \"Перезвонить клиенту по заявке с сайта\",\n        \"responsible\": {\"contentType\": \"Employee\", \"id\": 1000003},\n        \"subject\": \"Иван Петров, +7 999 000-11-22, интересуется доставкой\",\n        \"isUrgent\": true\n      }'","language":"bash","methods":["POST /api/v3/auth/access_token","POST /api/v3/task","POST /api/v3/task/{id}","GET /api/v3/employee"]},{"id":"sozdat-klienta-i-sdelku","title":"Создать клиента и сделку","summary":"Заявка превращается в клиента-компанию и сделку по нужной схеме.","steps":["Узнай схему сделки: GET /api/v3/program — у каждой схемы свой id и набор этапов.","Создай клиента: POST /api/v3/contractorCompany с contentType = ContractorCompany, name и contactInfo — списком контактов (type = email или phone, value, isMain).","Создай сделку: POST /api/v3/deal с contentType = Deal, program (схема), manager (сотрудник) и contractor — ссылкой на созданного клиента {\"contentType\": \"ContractorCompany\", \"id\": ...}.","Все ссылки на другие сущности — ссылочные объекты из contentType и id, а не просто числа."],"code":"curl -X POST https://<аккаунт>.megaplan.ru/api/v3/contractorCompany \\\n  -H \"AUTHORIZATION: Bearer $TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"contentType\": \"ContractorCompany\", \"name\": \"ООО \\\"Ромашка\\\"\",\n       \"contactInfo\": [{\"contentType\": \"ContactInfo\", \"isMain\": true, \"type\": \"email\", \"value\": \"info@romashka.ru\"}]}'\n\ncurl -X POST https://<аккаунт>.megaplan.ru/api/v3/deal \\\n  -H \"AUTHORIZATION: Bearer $TOKEN\" -H 'Content-Type: application/json' \\\n  -d '{\"contentType\": \"Deal\",\n       \"program\": {\"contentType\": \"Program\", \"id\": 8},\n       \"manager\": {\"contentType\": \"Employee\", \"id\": 1000003},\n       \"contractor\": {\"contentType\": \"ContractorCompany\", \"id\": 1000666},\n       \"description\": \"Заявка с сайта: поставка оборудования\"}'","language":"bash","methods":["POST /api/v3/deal","POST /api/v3/contractorCompany","GET /api/v3/program"]},{"id":"vygruzit-zadachi-s-filtrom","title":"Выгрузить задачи с фильтром и постранично","summary":"Забрать задачи в отчёт или BI: открытые, по ответственному, с нужными полями.","steps":["Запроси список: GET /api/v3/task. Параметры передаются JSON-объектом прямо в строке запроса — его нужно URL-кодировать.","Фильтр — объект с contentType = TaskFilter и условиями в config.termGroup.terms. Чтобы ответ был легче, передай fields со списком полей и onlyRequestedFields = true.","Пагинация курсорная: для следующей страницы передай pageAfter — ссылочный объект последней полученной задачи ({\"contentType\": \"Task\", \"id\": ...}), а не номер страницы. Размер страницы — limit, по умолчанию 100.","Коллекции отдают только базовые поля; полную карточку получай через GET /api/v3/task/{id}."],"code":"Q='{\"fields\": [\"name\", \"status\", \"deadline\", \"responsible\"], \"onlyRequestedFields\": true, \"limit\": 100}'\ncurl -G \"https://<аккаунт>.megaplan.ru/api/v3/task\" \\\n  -H \"AUTHORIZATION: Bearer $TOKEN\" \\\n  --data-urlencode \"$Q\"\n\n# Следующая страница — после последней задачи из предыдущего ответа\nQ='{\"limit\": 100, \"pageAfter\": {\"contentType\": \"Task\", \"id\": 1000245}}'\ncurl -G \"https://<аккаунт>.megaplan.ru/api/v3/task\" -H \"AUTHORIZATION: Bearer $TOKEN\" --data-urlencode \"$Q\"","language":"bash","methods":["GET /api/v3/task","GET /api/v3/task/{id}"]}],"baseUrls":[{"label":"Боевой","url":"https://<ваш-аккаунт>.megaplan.ru/api/v3/"},{"label":"Тестовый (демо-аккаунт)","url":"https://demo.megaplan.ru/api/v3/"}],"auth":{"type":"bearer","description":"Токен передаётся в каждом запросе в заголовке `AUTHORIZATION: Bearer <token>`. Для авторизации по логину и паролю токен получают запросом `POST /api/v3/auth/access_token` с `grant_type=password`; он живёт 48 часов (`expires_in` 172800). Приложения Мегаплана получают токен в `data->token` событий приложения.","example":"curl --request POST \\\n    --url https://demo.megaplan.ru/api/v3/auth/access_token \\\n    --header 'content-type: multipart/form-data;' \\\n    --form username=dev-null@megoplan.ru \\\n    --form password=123 \\\n    --form grant_type=password"},"methods":[{"id":"POST /api/v3/auth/access_token","title":"Получение токена","httpMethod":"POST","path":"/api/v3/auth/access_token","description":"В ответе: `access_token`, `expires_in`, `token_type`, `scope`, `refresh_token`.","params":[{"name":"username","in":"body","type":"string","required":true,"description":"Логин пользователя"},{"name":"password","in":"body","type":"string","required":true,"description":"Пароль"},{"name":"grant_type","in":"body","type":"string","required":true,"description":"password"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v3/task","title":"Список задач","httpMethod":"GET","path":"/api/v3/task","description":"Параметры передаются JSON-объектом в GET-параметрах.","params":[{"name":"filter","in":"query","type":"object","required":false,"description":"Фильтр с contentType: \"TaskFilter\" и config.termGroup.terms — условия по полям (userCreated, responsible, status и др.)"},{"name":"onlyRequestedFields","in":"query","type":"boolean","required":false,"description":"Отдавать только запрошенные поля"},{"name":"fields","in":"query","type":"array","required":false,"description":"Список запрашиваемых полей"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер страницы, по умолчанию 100"},{"name":"pageAfter","in":"query","type":"object","required":false,"description":"Ссылочная сущность, после которой начать страницу"},{"name":"pageBefore","in":"query","type":"object","required":false,"description":"Ссылочная сущность, до которой выдать страницу"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v3/task/{id}","title":"Карточка задачи","httpMethod":"GET","path":"/api/v3/task/{id}","description":"Коллекции возвращают только базовые поля; полный набор — в карточке.","params":[{"name":"id","in":"path","type":"integer","required":true,"description":"ID задачи"},{"name":"onlyRequestedFields","in":"query","type":"boolean","required":false,"description":"Отдавать только запрошенные поля"},{"name":"fields","in":"query","type":"array","required":false,"description":"Поля, например name, status, deadline, responsible"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/task","title":"Создать задачу","httpMethod":"POST","path":"/api/v3/task","description":"","params":[{"name":"contentType","in":"body","type":"string","required":true,"description":"Task"},{"name":"name","in":"body","type":"string","required":true,"description":"Название задачи"},{"name":"responsible","in":"body","type":"object","required":true,"description":"Ответственный: {\"contentType\": \"Employee\", \"id\": ...}"},{"name":"subject","in":"body","type":"string","required":false,"description":"Описание"},{"name":"isUrgent","in":"body","type":"boolean","required":false,"description":"Срочная"},{"name":"isTemplate","in":"body","type":"boolean","required":false,"description":"Шаблон"},{"name":"Category...CustomField...","in":"body","type":"any","required":false,"description":"Расширенные (пользовательские) поля"}],"requestExample":"{\n    \"contentType\": \"Task\",\n    \"name\": \"Название задачи\",\n    \"responsible\": {\n        \"contentType\": \"Employee\",\n        \"id\": 1000003\n    },\n    \"subject\": \"Описание задачи\",\n    \"isUrgent\": false,\n    \"isTemplate\": false\n}","responseExample":"","docsUrl":""},{"id":"POST /api/v3/task/{id}","title":"Изменить задачу","httpMethod":"POST","path":"/api/v3/task/{id}","description":"Изменение выполняется POST-запросом на адрес задачи с изменяемыми полями.","params":[{"name":"id","in":"path","type":"integer","required":true,"description":"ID задачи"},{"name":"name","in":"body","type":"string","required":false,"description":"Новое название"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"DELETE /api/v3/task/{id}","title":"Удалить задачу","httpMethod":"DELETE","path":"/api/v3/task/{id}","description":"","params":[{"name":"id","in":"path","type":"integer","required":true,"description":"ID задачи"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/deal","title":"Создать сделку","httpMethod":"POST","path":"/api/v3/deal","description":"","params":[{"name":"contentType","in":"body","type":"string","required":true,"description":"Deal"},{"name":"program","in":"body","type":"object","required":true,"description":"Схема сделки: {\"contentType\": \"Program\", \"id\": ...}"},{"name":"manager","in":"body","type":"object","required":false,"description":"Менеджер: {\"contentType\": \"Employee\", \"id\": ...}"},{"name":"contractor","in":"body","type":"object","required":false,"description":"Клиент: {\"contentType\": \"ContractorCompany\", \"id\": ...}"},{"name":"description","in":"body","type":"string","required":false,"description":"Описание"}],"requestExample":"{\n    \"contentType\": \"Deal\",\n    \"program\": {\n        \"contentType\": \"Program\",\n        \"id\": 8\n    },\n    \"manager\": {\n        \"contentType\": \"Employee\",\n        \"id\": 1000003\n    },\n    \"contractor\": {\n        \"contentType\": \"ContractorCompany\",\n        \"id\": 1000666\n    },\n    \"description\": \"Описание\"\n}","responseExample":"","docsUrl":""},{"id":"GET /api/v3/deal","title":"Список сделок","httpMethod":"GET","path":"/api/v3/deal","description":"","params":[{"name":"filter","in":"query","type":"object","required":false,"description":"Фильтр с contentType: \"TradeFilter\"; условия по manager, state и др.; для расширенных полей — program"},{"name":"limit","in":"query","type":"integer","required":false,"description":"Размер страницы"}],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/v3/contractorCompany","title":"Создать клиента-компанию","httpMethod":"POST","path":"/api/v3/contractorCompany","description":"","params":[{"name":"contentType","in":"body","type":"string","required":true,"description":"ContractorCompany"},{"name":"name","in":"body","type":"string","required":true,"description":"Название"},{"name":"contactInfo","in":"body","type":"array","required":false,"description":"Контакты: contentType: \"ContactInfo\", type (например email), value, isMain"}],"requestExample":"{\n    \"contentType\": \"ContractorCompany\",\n    \"name\": \"ООО \\\"Ромашка\\\"\",\n    \"contactInfo\": [{\n        \"contentType\": \"ContactInfo\",\n        \"isMain\": true,\n        \"type\": \"email\",\n        \"value\": \"romashka45986521@gmail.com\"\n    }]\n}","responseExample":"","docsUrl":""},{"id":"GET /api/v3/employee","title":"Список сотрудников","httpMethod":"GET","path":"/api/v3/employee","description":"Список сотрудников аккаунта; карточка — `GET /api/v3/employee/{id}`.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"GET /api/v3/program","title":"Схемы сделок","httpMethod":"GET","path":"/api/v3/program","description":"Список схем сделок; карточка — `GET /api/v3/program/{id}`.","params":[],"requestExample":"","responseExample":"","docsUrl":""},{"id":"POST /api/file","title":"Загрузка файла","httpMethod":"POST","path":"/api/file","description":"Загрузка файла multipart-формой (поле `files[]`). В ответе — `id` файла, который затем указывают в создаваемой сущности вместе с `contentType`.","params":[],"requestExample":"curl 'https://demo.megaplan.ru/api/file'\n-H 'content-type: multipart/form-data;'\n-F 'files[]=@/path/to/file'","responseExample":"","docsUrl":""}],"codeExamples":[],"errors":[{"code":"200","description":"Успешно"},{"code":"403","description":"Ошибка доступа"},{"code":"422","description":"Ошибка в запросе"}],"limits":"","gotchas":["Ответ всегда в конверте `meta` + `data`: в `meta` — `status`, ошибки и `pagination` (`count`, `limit`).","Параметры GET-запросов передаются JSON-объектом прямо в строке запроса, например `GET /api/v3/currency?{\"limit\": \"3\"}`.","Пагинация курсорная: `pageAfter`/`pageBefore` принимают ссылочную сущность (`contentType` + `id`), а не номер страницы.","Коллекции отдают только базовые поля; для полного набора запросите карточку по `id` или передайте `fields`.","Изменение сущности — `POST` на её адрес (`/api/v3/task/{id}`), а не PUT или PATCH.","Пользовательские поля имеют имена вида `Category130CustomField...`; для фильтра по расширенным полям сделок нужно указать схему `program`.","Полный список сущностей и эндпоинтов публикуется на каждом аккаунте: `/api/v3/docs`; RAML-описание — `/api/v3`.","Пример ответа:"],"slug":"megaplan","version":2,"updatedAt":"2026-10-24T17:05:34.221Z","sources":[{"title":"API v3","url":"https://dev.megaplan.ru/apiv3/index.html","kind":"research","addedAt":"2026-10-12T11:07:55.247Z"},{"title":"Документация для разработчиков","url":"https://dev.megaplan.ru/","kind":"research","addedAt":"2026-10-12T11:07:55.247Z"},{"title":"Официальный PHP SDK с примерами запросов","url":"https://github.com/megaplan/megaplansdk","kind":"research","addedAt":"2026-10-12T11:07:55.247Z"},{"title":"Вставленный текст","url":"","kind":"import","addedAt":"2026-10-12T11:07:55.247Z"},{"title":"scenarios-megaplan.md","url":"","kind":"import","addedAt":"2026-10-24T17:05:25.401Z"}],"logoUrl":null}