Создание организации

POST https://gptunnel.ru/api/v1/orgs/create

Создаёт новую бизнес-организацию и назначает ей владельца — уже зарегистрированного пользователя. Владелец видит организацию в своём кабинете сразу, с ролью «Владелец». Дальше на счёт организации можно переводить средства по org_id из ответа.

Созданной организации не выставляются автоматические ежемесячные счета: расчёты с ней ведёт партнёр.

Headers

Параметр	Тип	Описание
`Authorization`*	`string`	API ключ организации
`Idempotency-Key`*	`string`	Уникальный ключ операции, 8–64 символа A-Za-z0-9_-
`Content-Type`*	`string`	application/json

Параметры запроса

Параметр	Тип	Описание
`name`*	`string`	Название организации, 1–255 символов
`owner`*	`object`	Владелец: { "user_id": "<24 hex строчными>" } — существующий пользователь
`inn`	`string`	ИНН, 10 или 12 цифр
`ogrn`	`string`	ОГРН или ОГРНИП, 13 или 15 цифр

Пример запроса

curl --request POST \
  --url https://gptunnel.ru/api/v1/orgs/create \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Idempotency-Key: client-4821-org' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "ООО Ромашка",
    "owner": { "user_id": "6ad72133269dc8d9f75a33bc" },
    "inn": "7707083893",
    "ogrn": "1027700132195"
}'

import axios from 'axios'

const response = await axios({
  method: 'POST',
  url: 'https://gptunnel.ru/api/v1/orgs/create',
  headers: {
    Authorization: 'YOUR_API_KEY',
    'Idempotency-Key': 'client-4821-org',
  },
  data: {
    name: 'ООО Ромашка',
    owner: { user_id: '6ad72133269dc8d9f75a33bc' },
    inn: '7707083893',
    ogrn: '1027700132195',
  },
})

console.log(response.data)

import requests

response = requests.post(
    'https://gptunnel.ru/api/v1/orgs/create',
    headers={
        'Authorization': 'YOUR_API_KEY',
        'Idempotency-Key': 'client-4821-org',
    },
    json={
        'name': 'ООО Ромашка',
        'owner': {'user_id': '6ad72133269dc8d9f75a33bc'},
        'inn': '7707083893',
        'ogrn': '1027700132195',
    },
)

print(response.json())

Ответ

Поля ответа

Параметр	Тип	Описание
`code`	`number`	0 при успехе
`org_id`	`string`	ID созданной организации — используйте его в переводах
`account`	`string`	Номер лицевого счёта: ЛСО-<номер>, если передан ИНН или ОГРН, иначе B-RU-<номер>
`owner_user_id`	`string`	ID владельца
`owner_created`	`boolean`	Всегда false при назначении существующего пользователя
`inn`	`string \| null`	ИНН организации, null если не передавали
`ogrn`	`string \| null`	ОГРН или ОГРНИП организации, null если не передавали
`created_at`	`string`	Время создания организации, ISO 8601
`replayed`	`boolean`	true, если это повтор по тому же Idempotency-Key и организация уже была создана раньше

200 OK
409 Дубль ОГРН

{
  "code": 0,
  "org_id": "67f3b9d1a0c4e2f345678901",
  "account": "ЛСО-16966",
  "owner_user_id": "6ad72133269dc8d9f75a33bc",
  "owner_created": false,
  "inn": "7707083893",
  "ogrn": "1027700132195",
  "created_at": "2026-10-20T09:15:42.000Z",
  "replayed": false
}

{
  "code": 41,
  "message": "An organization with this OGRN is already registered."
}

Повтор запроса с тем же Idempotency-Key, тем же названием, владельцем, ИНН и ОГРН возвращает уже созданную организацию с replayed: true, новая не заводится. Тот же ключ с другими данными — 409, код 20.

Ошибки

HTTP	code	Когда
400	3	Тело не по схеме, лишнее поле, владелец — служебный аккаунт сотрудника. Для ошибок схемы подробности — в поле `details`
400	21	Нет заголовка `Idempotency-Key` или он не по формату
403	13	Ключ личного аккаунта
403	32	Создание организаций не включено для вашей организации
403	33	Владелец по телефону недоступен для вашей организации
404	17	Пользователь по `owner.user_id` не найден или удалён
409	20	`Idempotency-Key` уже использован с другими данными
409	41	Организация с таким ОГРН уже зарегистрирована
409	42	Организация с таким ИНН уже зарегистрирована