---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.kz/routing/doc/en/delivery/quickstart/courier.md
  - https://yandex.kz/routing/doc/kk/delivery/quickstart/courier.md
  - https://yandex.kz/routing/doc/ru/delivery/quickstart/courier.md
  - https://yandex.kz/routing/doc/tr/delivery/quickstart/courier.md
  - href: en/delivery/quickstart/courier.md
    type: text/markdown
    title: Markdown version
  - href: ../llms.txt
    type: text/markdown
    title: llms.txt
title: RouteQ — API implementation procedure — adding couriers
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.kz/routing/doc/en/llms.txt


# Adding couriers

After adding depots, add a list of couriers who will complete orders to the database.

{% note info %}

<!-- source: en/delivery/_includes/poluchenie-ID.md -->
Use your company ID to access the Track & Trace API. If you don't have an ID, [contact us](mailto:routing@yandex-team.ru).
<!-- endsource: en/delivery/_includes/poluchenie-ID.md -->

{% endnote %}


**Via Routing Workspace**

1. <!-- source: en/delivery/_includes/open-logist-workplace.md -->
   Open [Routing Workspace](https://yandex.com/courier/companies/).
   <!-- endsource: en/delivery/_includes/open-logist-workplace.md -->
1. In the menu on the left, go to **Track & Trace** → **Couriers**.
1. Enter each courier's information (phone number and username) and click **Add**. 

    <!-- source: en/delivery/_includes/login-phone.md -->
    If you use the courier's mobile phone number in the `+1хххххххххх` format as their login, they won't have to enter a username to log in to the [RouteQ](https://yandex.kz/routing/doc/en/rq-app/index.md) app.
    <!-- endsource: en/delivery/_includes/login-phone.md -->

    To learn how to register couriers, see [Managing the courier list](https://yandex.kz/routing/doc/en/delivery/interface/couriers.md#couriers-options).

1. In the menu on the left, go to **Settings** → **Mobile app**.
1. Enter the couriers' phone numbers and click **Add**. These couriers will be able to use the [RouteQ](https://yandex.kz/routing/doc/en/rq-app/index.md) app. 

    To learn how to add couriers, see [Couriers](https://yandex.kz/routing/doc/en/delivery/interface/add-couriers.md).  
    

**Via the API**

{% note info %}

When you add a courier using the API, you can enter their phone number (`phone`), username (`number`), and name (`name`).

{% endnote %}


Send a request to the [couriers-batch](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/editsMultipleMobileEmployees) resource. The request must contain information about the employees.

<!-- source: en/_includes/postman-collection.md -->
To send API requests, you can use the [Routing API](https://doc-static.yandex.net/src/dev/routing/postman-collection/routeq-api-postman-collection-en.zip) collection. To learn how to import the collection into Postman or Bruno, see [Working with an existing request collection](https://yandex.kz/routing/doc/en/vrp/upload-api-collection.md).
<!-- endsource: en/_includes/postman-collection.md -->


{% note alert %}

The specification contains required fields for existing objects, but there are more fields for new objects. When you add new objects by sending a request to the `couriers-batch` resource, fill in all of the fields that are required for the [couriers](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/addsAMobileEmployee) resource.

{% endnote %}

**Request:**

{% list tabs %}

- Windows

  cURL

  ```html
  curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-token>" -X POST -d @<File_path_in_UTF-8_encoding> https://courier.yandex.ru/api/v1/companies/<your-company-id>/couriers-batch
  ```

  File

  
  
  ```json
  [
    {
      "number":"222",
      "phone":"+15551234567",
      "name":"Mark"
    },
    {
      "number":"224",
      "phone":"+15551234568",
      "name":"Sarah"
    }
  ]
  ```
  


- MacOS/Linux
  
  cURL

  
  
  ```html
  curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-OAuth-token>" -X POST -d '[{"number":"222", "phone":"+15551234567", "name":"Mark"}, {"number":"224", "phone":"+15551234568", "name":"Sara"}]' https://courier.yandex.ru/api/v1/companies/<your-company-id>/couriers-batch
  ```
  


{% endlist %}

**Result:**

```json
{
  "inserted": 2,
  "updated": 0
}
```

## Couriers' phone numbers for the RouteQ app {#courier-number}

If couriers use the RouteQ app, you need to add their numbers to the database, otherwise they won't be able to use the app.

**Via Routing Workspace**

1. <!-- source: en/delivery/_includes/open-logist-workplace.md -->
   Open [Routing Workspace](https://yandex.com/courier/companies/).
   <!-- endsource: en/delivery/_includes/open-logist-workplace.md -->
1. In the menu on the left, go to **Settings** → **Mobile app**.
1. Enter the courier's phone number and click **Add**.

You can add multiple couriers' phone numbers at once. To do so, enter the numbers separated by a comma.

**Via the API**

: Send a request to the [app-user](https://yandex.ru/routing/doc/en/delivery/redoc/index.html#operation/addsThePhoneNumberOfTheCourierWhoWillWorkWithTheMobileApplication) resource. In the request, specify the courier's phone number in E.164 format. Example: `+79012345678`.

<!-- source: en/_includes/postman-collection.md -->
To send API requests, you can use the [Routing API](https://doc-static.yandex.net/src/dev/routing/postman-collection/routeq-api-postman-collection-en.zip) collection. To learn how to import the collection into Postman or Bruno, see [Working with an existing request collection](https://yandex.kz/routing/doc/en/vrp/upload-api-collection.md).
<!-- endsource: en/_includes/postman-collection.md -->

**Request:**

{% list tabs %}

- Windows

  cURL

  ```html
  curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-token>" -X POST -d @<File_path_in_UTF-8_encoding> https://courier.yandex.ru/api/v1/companies/<your-company-id>/app-user
  ```

  File

  
  
  ```json
  {
    "login":"+15551234567"
  }
  ```
  


- MacOS/Linux
  
  cURL

  
  
  ```html
  curl -H "Content-Type: application/json" -H "Authorization: OAuth <your-OAuth-token>" -X POST -d '{"login":"+15551234567"}' https://courier.yandex.ru/api/v1/companies/<your-company-id>/app-user
  ```
  


{% endlist %}

**Result:**

```json
{}
```

<!-- source: en/delivery/_includes/feedback.md -->
<a href="../feedback">
  <span class="button">Contact support</span>
</a>



[//]: # (Version without HTML\: \[Contact support\]\(../../../feedback.md\))
<!-- endsource: en/delivery/_includes/feedback.md -->