Let's explore together how to update your supplier profiles with Postman: adding or editing names and descriptions in several languages (short and/or long description).

Before starting, we recommend consulting the article ✍️ Update your catalog products via the API (Postman), which details how to retrieve the API key, the token, and how to configure Postman.

Prerequisites

Before diving into creating your request, make sure you have retrieved the following elements:

Your Ezus API key → x-api-key header.
A valid token (via /login, valid for 12h) → Authorization: Bearer … header.
The API field: this is a unique reference that identifies the supplier(s) you wish to modify.

⚠️ Make sure that the languages in which you want to update your supplier profiles are properly enabled in your Ezus account settings. Otherwise, the request will be rejected by the API.

Where do I find my supplier's API reference?

Directly from the supplier profile:

From your catalog:

Useful if you want to retrieve the information for several suppliers: you can also export this data by clicking on the three little dots, then on the Export button.

💡 If you don't see this column in your table, you'll need to add it. To do so, click on the three little dots on the right, then on the "Edit columns" button.

Add multilingual descriptions

To add or edit descriptions, use the suppliers-upsert route with the langs block. Each language is an object containing the supplier's name and descriptions in that language.

Any other information on your supplier profile (address, category, tags, etc.) will not be affected.

Step 1 — Create the request

POST method, URL: https://api.ezus.app/suppliers-upsert

Step 2 — Headers

x-api-key → your API key
Authorization → Bearer followed by your token
Content-Type → application/json

Step 3 — Content (Body → raw → JSON)

{ "reference": "SUPPLIER_REFERENCE", "langs": [ { "lang": "french", "name": "Nom du fournisseur", "short_description": "Une description courte en français", "long_description": "Une description longue en français" }, { "lang": "english", "name": "Supplier name", "short_description": "A short description in English", "long_description": "A long description in English" }, { "lang": "spanish", "name": "Nombre del proveedor", "short_description": "Una descripción corta en español", "long_description": "Una descripción larga en español" } ] }

Field descriptions:

reference: corresponds to the "API field" data in Ezus (required).
langs: an array, with one object per language.
lang: the language of the object. Always in lowercase and in English: french, english, american, spanish, italian, german, dutch, portuguese…
name: the supplier's displayed name in that language.
short_description: short description.
long_description: long description.

💡 Good to know: it is recommended to update all the languages used in a single call (the langs block sets the descriptions for the languages provided).

Step 4 — Send and check

Click Send. Expected response:

{ "error": "false", "message": "ok", "action": "Supplier successfully updated", "reference": "SUPPLIER_REFERENCE" }

We recommend checking in Ezus that the descriptions appear correctly in each language.

What about images (logo, visuals, media)?

To date, a supplier's images cannot be added via the API. The suppliers-upsert route does not include any field for the logo, visuals, or media. These elements appear in read-only mode when consulting a profile (GET supplier request), but cannot be modified via the API.

To add images to your supplier profiles, two options:

From the Ezus interface: directly from the supplier profile.
Via an import: contact your Customer Success Manager to learn more.

Enrich several suppliers at once

Group one request per supplier in a collection, then launch the Collection Runner:

Hover over the collection → ··· → Run collection.
Check the ticked requests, leave a delay of about 200 ms, keep "Stop run if an error occurs" ticked.
Click Run: Passed / Failed status per supplier.

💡 We recommend first testing a single request successfully before launching the full run.

Troubleshooting common problems

401 / 403 error: check the API key and the token (regenerate it if it has expired).
Language rejected: the language must be enabled in the account Settings, and spelled in English (french, english, spanish…).
The description does not appear: check that the reference indeed corresponds to an existing supplier ("API field" column).

Update your supplier profiles via the API (Postman)