Массовый импорт сотрудников

POST https://gptunnel.ru/api/v1/employees/importEmployees

Массово создаёт аккаунты сотрудников по списку email. Для каждого адреса email становится логином, пароль генерируется автоматически, а доступы отправляются письмом. Каждый адрес обрабатывается независимо: невалидные и уже состоящие в организации не отменяют обработку остальных.

Если аккаунт с таким email уже зарегистрирован в сервисе и не состоит в вашей организации, новый аккаунт не создаётся: человеку отправляется приглашение в организацию, как при приглашении из личного кабинета. Такой адрес считается в created, как и новый. Сотрудник появится в организации, когда примет приглашение, а до этого в списке сотрудников у него виден только логин. Аккаунт, созданный другой организацией, в чужую организацию не приглашается: ответ тот же, но сотрудник в списке не появится.

Headers

Параметр	Тип	Описание
`Authorization`*	`string`	API ключ

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

Параметр	Тип	Описание
`emails`*	`string[]`	Массив email (от 1 до 25). Email используется как логин

Причины ошибок

Параметр	Тип	Описание
`invalid_email`	`string`	Неверный формат email
`already_exists`	`string`	Сотрудник с таким логином или email уже есть в организации
`error`	`string`	Непредвиденная ошибка при создании

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

curl --request POST \
  --url https://gptunnel.ru/api/v1/employees/importEmployees \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "emails": ["ivanov@example.com", "petrov@example.com"]
}'

import axios from 'axios'

const response = await axios({
  method: 'POST',
  url: 'https://gptunnel.ru/api/v1/employees/importEmployees',
  headers: {
    Authorization: 'YOUR_API_KEY',
  },
  data: {
    emails: ['ivanov@example.com', 'petrov@example.com'],
  },
})

console.log(response.data)

import requests

response = requests.post(
    'https://gptunnel.ru/api/v1/employees/importEmployees',
    headers={'Authorization': 'YOUR_API_KEY'},
    json={
        'emails': ['ivanov@example.com', 'petrov@example.com'],
    },
)

print(response.json())

Пример ответа

{
  "code": 0,
  "created": 1,
  "failed": 1,
  "failedEmails": [
    {
      "email": "petrov@example.com",
      "reason": "already_exists",
      "message": "Employee with this login or email is already in the organization."
    }
  ]
}

{
  "code": 3,
  "message": "Invalid input, check schema issues.",
  "details": []
}

{
  "error": {
    "message": "Unauthorized",
    "type": "unauthorized_request_error",
    "param": null,
    "code": null
  }
}

{
  "code": 7,
  "message": "Not allowed to perform this action for the organization."
}

{
  "code": 13,
  "message": "This section is not available from a personal account. Use a business organization API key."
}

{
  "code": 43,
  "message": "Too many employee creation requests, retry later."
}

{
  "code": 1,
  "message": "Internal server error.",
  "trace_id": "66a346f64dcb57627c03d596"
}