Nextora / Разработчикам
Ваше рабочее пространство,
программируемо.
A REST API for contacts, companies, deals, tasks and leads. Signed webhooks for every change, whether it came from the app, the API, a workflow or an import. An MCP server for AI clients. Every example on these pages uses your workspace.
https://.nextora.co/api/v1
Type your workspace — every example follows.
- Версия2026-10-10
- СпецификацияOpenAPI 3.1
- Лимит500 запросов/мин
GET/api/v1/deals
curl -G https://acme.nextora.co/api/v1/deals \
-H "Authorization: Bearer $NEXTORA_API_KEY" \
-d status=in_progress \
-d limit=1Response200 OK
{
"data": [
{
"id": "8f2d6c1a-4b7e-4f0a-9c3d-2e1b5a6f7c80",
"title": "Northwind Analytics — annual plan",
"value": 24000,
"currency": "EUR",
"status": "in_progress",
"stage": {
"name": "Proposal",
"type": "open"
},
"expected_close_date": "2026-11-27"
}
],
"meta": {
"limit": 1,
"has_more": true,
"next_cursor": "eyJpZCI6IjhmMmQ2YzFhIn0"
}
}Начать здесь
Быстрый старт за пять минут- 01Создать ключSettings → Developers → API keys. Pick only the scopes you need; the key is shown once.
- 02Отправить запросSend it as a bearer token. Lists page with cursors; errors carry a stable code.
- 03Отслеживать измененияПодписанные события для каждого изменения — из приложения, API, автоматизаций и импортов.
Справочник API
Скачать спецификацию OpenAPI- Contacts Люди, их компания, ответственный, теги и пользовательские поля.
/api/v1/contacts - Companies Организации с отраслью, размером и ответственным.
/api/v1/companies - Deals Сумма, этап, категория прогноза, выиграна и проиграна.
/api/v1/deals - Pipelines Воронки и этапы с вероятностями.
/api/v1/pipelines - Задачи Дела со статусом, приоритетом, датами и подзадачами.
/api/v1/tasks - Лиды Входящий интерес со статусом, источником и баллом.
/api/v1/leads - Notes Заметки по контактам, компаниям, сделкам и лидам.
/api/v1/notes - Пользователи Пользователи рабочего пространства, для назначения ответственных.
/api/v1/users - Пользовательские поля Определения пользовательских полей по типам записей.
/api/v1/custom-fields - Forecast Итоги воронки по категориям прогноза.
/api/v1/forecast - Webhook subscriptions Подписки, доставки, повторные попытки и секреты.
/api/v1/webhooks
Соглашения
Одни и те же правила на каждом эндпоинте, поэтому один клиент работает со всеми.
- Базовый URL
https://{workspace}.nextora.co/api/v1— custom domains work the same.- Аутентификация
Authorization: Bearer sk_live_…, with scopes. A key acts as its owner.- Формат
- JSON in and out, snake_case, ISO 8601 timestamps in UTC.
- Ошибки
- One shape everywhere:
code,message,details,request_id. - Пагинация
- Cursors:
limitup to 100 andmeta.next_cursor. - Лимиты запросов
- 500 requests a minute per key, with headers on every response.
- Идемпотентность
Idempotency-Keyon POST replays the original response for 24 hours.- Версионирование
- Version
2026-10-10. Breaking changes only with 90 days’ notice.
Помимо REST
- Вебхуки Twenty events, signed with HMAC-SHA256, retried automatically when your endpoint fails.
- MCP-сервер Claude, ChatGPT и Cursor в вашем рабочем пространстве, через OAuth 2.1.
- Вебхуки автоматизаций Запускайте автоматизацию из любой системы одним POST.
- Веб-формы Отправляйте заявки с форм вашего сайта в систему как лиды.