Skip to content

Update Contacts List ​

http
PUT /api/v3/dbw/warehouses/{warehouseId}/contacts

Base URL: https://marketplace-api.wildberries.ru · Module: items · Section: Seller Warehouses · Specification doc ↗

Updates the seller warehouse contacts list.

The contacts list is overwritten upon update. Therefore, you need to include all contacts list parameters in the request, including those you do not intend to update

Only for warehouses with delivery type 3 — Delivery WB (DBW).

A maximum of 5 contacts can be added to the warehouse. To delete contacts, send an empty contacts array.

Request limit per one seller account for DBW methods:

  • for getting and updating contact lists
  • for getting and deleting label identifiers
  • assembly orders
PeriodLimitIntervalBurst
1 min300 requests200 ms20 requests
One request with 4XX response codes is counted as 10 requests

Request body ​

application/json — schema StoreContactRequestBody, required

  • contacts object[]
    • comment string — Comment
    • phone string — Phone number. Supported country codes: - +7 — Russia, Kazakhstan - +374 — Armenia - +375 — Belarus - +996 — Kyrgyzstan

Responses ​

CodeDescriptionSchema
204Updated—
400Bad requestError
401Unauthorizedobject
402Payment requiredobject
403Access deniedError
429Too many requestsobject

Structure 400:

  • code string — Error code
  • message string — Error details

Structure 401:

  • title string — Error title
  • detail string — Error details
  • code string — Internal error code
  • requestId string — Unique request ID
  • origin string — WB internal service ID
  • status number — HTTP status code
  • statusText string — Text of the HTTP status code
  • timestamp string — Request date and time

Structure 402:

Structure 403:

  • code string — Error code
  • message string — Error details

Structure 429:

  • title string — Error title
  • detail string — Error details
  • code string — Internal error code
  • requestId string — Unique request ID
  • origin string — WB internal service ID
  • status number — HTTP status code
  • statusText string — Text of the HTTP status code
  • timestamp string — Request date and time

Call examples ​

Arguments are shown as parameter names — substitute your own values. Languages whose client does not expose this operation are omitted.

python
from wb_api_client.items import Configuration, ApiClient
from wb_api_client.items.api import ItemsApi

cfg = Configuration(access_token="<your WB JWT>")
api = ItemsApi(ApiClient(cfg))

result = api.put_v3_dbw_warehouses_warehouse_id_contacts(warehouse_id=..., store_contact_request_body=...)
print(result)
ts
import {
  Configuration,
  ItemsApi,
} from "@valeryverkhoturov/wb-api-client/items";

const cfg = new Configuration({});
cfg.setAccessToken("<your WB JWT>");
const api = new ItemsApi(cfg);

const { data } = await api.putV3DbwWarehousesWarehouseIdContacts(warehouseId, storeContactRequestBody);
console.log(data);
go
import (
	"context"
	"fmt"

	wbitems "github.com/ValeryVerkhoturov/wb-api-client-go/items"
)

cfg := wbitems.NewConfiguration()
cfg.SetAccessToken("<your WB JWT>")
client := wbitems.NewAPIClient(cfg)

result, _, err := client.ItemsAPI.PutV3DbwWarehousesWarehouseIdContacts(context.Background(), warehouseId).StoreContactRequestBody(storeContactRequestBody).Execute()
if err != nil {
    panic(err)
}
fmt.Printf("%+v\n", result)
java
import io.github.valeryverkhoturov.wbapi.items.ApiClient;
import io.github.valeryverkhoturov.wbapi.items.SecretString;
import io.github.valeryverkhoturov.wbapi.items.api.ItemsApi;

ApiClient client = new ApiClient();
client.setAccessToken(new SecretString("<your WB JWT>"));
ItemsApi api = new ItemsApi(client);

System.out.println(api.putV3DbwWarehousesWarehouseIdContacts(warehouseId, storeContactRequestBody));
php
use ValeryVerkhoturov\WbApiClient\Items\Configuration;
use ValeryVerkhoturov\WbApiClient\Items\SecretString;
use ValeryVerkhoturov\WbApiClient\Items\Api\ItemsApi;
use GuzzleHttp\Client;

$config = (new Configuration())
    ->setAccessTokenSecret(new SecretString('<your WB JWT>'));
$api = new ItemsApi(new Client(), $config);

print_r($api->putV3DbwWarehousesWarehouseIdContacts($warehouse_id, $store_contact_request_body));
bsl
#Использовать "wb-api-client"

Настройки = Новый Конфигурация();
Настройки.УстановитьТокен("<your WB JWT>");
Клиент = Новый ItemsApi(Настройки);

Сообщить(Клиент.PutV3DbwWarehousesWarehouseIdContacts(warehouseId, Тело).Тело);
csharp
using ValeryVerkhoturov.WbApiClient.Items.Api;
using ValeryVerkhoturov.WbApiClient.Items.Client;

var config = new Configuration();
config.AccessTokenSecret = new SecretString("<your WB JWT>");
var api = new ItemsApi(config);

Console.WriteLine(api.PutV3DbwWarehousesWarehouseIdContacts(warehouseId, storeContactRequestBody));
rust
use wb_api_client::items::apis::{configuration::Configuration, items_api};

#[tokio::main]
async fn main() {
    let mut cfg = Configuration::new();
    cfg.set_access_token("<your WB JWT>");

    let result = items_api::put_v3_dbw_warehouses_warehouse_id_contacts(&cfg, warehouse_id, store_contact_request_body).await;
    println!("{:#?}", result);
}