---
metadata:
  - name: generator
    content: Diplodoc Platform v5.19.6
alternate:
  - https://docs.routeq.com/doc/en/delivery/quickstart/courier.md
  - https://docs.routeq.com/doc/tr/delivery/quickstart/courier.md
title: RouteQ — API implementation procedure — adding couriers
---
> **Documentation Index:** Fetch the complete configuration index at https://docs.routeq.com/doc/en/llms.txt


# Adding couriers

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

{% note info %}

{% include [warehouse-poluchenie-ID](../_includes/poluchenie-ID-64cccc844b69.md) %}

{% endnote %}


**Via Routing Workspace**

1. {% include [open-logist-workplace-companies](../_includes/open-logist-workplace-c693389b040b.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**. 

    {% include [couriers-options-login-phone](../_includes/login-phone-f517a85a1d52.md) %}

    To learn how to register couriers, see [Managing the courier list](https://docs.routeq.com/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 [Yandex Courier](https://docs.routeq.com/doc/en/delivery/app.md) app. 

    To learn how to add couriers, see [Couriers](https://docs.routeq.com/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.

{% include [postman-collection](../_includes/postman-collection-c7a3adefee03.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
}
```

## Phone numbers for Yandex Courier {#courier-number}

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

**Via Routing Workspace**

1. {% include [open-logist-workplace-companies](../_includes/open-logist-workplace-c693389b040b.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`.

{% include [postman-collection](../_includes/postman-collection-c7a3adefee03.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
{}
```

{% include [warehouse-feedback](../_includes/feedback-7b71896f9bc3.md) %}