Assign a distributor ID to an address (tenant:masterdata:write)
PUT /api/masterdata/distributor-ids/{source}/{distributorId}
Module: Master data · operationId: assignDistributorId · Tag: Distributor IDs · Auth: access token (Authorization: Bearer <accessToken>)
Links the distributor ID with the address; an ID already linked with another address moves to the new one. An omitted distributorName keeps the stored name. Emits masterdata.distributor_id.assigned.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
source |
path | string | yes | Distributor source, lower-case (egis, ingram, infinigate, amazon, …) |
distributorId |
path | string | yes | The distributor's own supplier ID (matched case-insensitively) (max length 64) |
Request body
application/json (required)
addressId(string (uuid), required): Supplier address the distributor stands fordistributorName(string): Name of the distributor (kept when empty) (max length 255)
Example:
{
"addressId": "3f6c1a52-7b1e-4d2a-9c8e-2b5f0d6a91e4",
"distributorName": "EGIS Computer Service-Center GmbH"
}
Responses
- 200 Assigned (
application/json) - 400 Malformed body or query parameter (
application/json) - 401 Missing, invalid or expired token (empty body)
- 403 The token lacks the permission or carries no tenant (
application/json)
Fields of the 200 answer:
addressId(string (uuid), required): Supplier address the distributor ID maps toaddressName(string, required): Display name of that addressadrNr(string, required): Address number of that addressdistributorId(string, required): The distributor's own IDsource(string, required): Distributor (lower case, e.g. egis, ingram)updatedAt(string (date-time), required): Time of the last changedistributorName(string): Name of the distributor
Example 200 answer:
{
"addressId": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c1e",
"addressName": "Alpenhotel Seeblick GmbH \u0026 Co. KG",
"adrNr": "10001",
"distributorId": "700123",
"distributorName": "EGIS Computer Service-Center GmbH",
"source": "egis",
"updatedAt": "2026-05-20T11:40:00Z"
}
Example request
curl -X PUT 'https://api.mbcom.cloud/api/masterdata/distributor-ids/egis/700123' \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
--data '{"addressId":"3f6c1a52-7b1e-4d2a-9c8e-2b5f0d6a91e4","distributorName":"EGIS Computer Service-Center GmbH"}'