Commandes & expéditions
Créer, lire, suivre ; devis signés et achat d'étiquette.
Développeurs
Vous accédez à l'API avec un compte activé ; le SDK TypeScript se télécharge depuis le portail développeur, avec vos clés.

Démarrer
Vous la créez dans le portail développeur une fois votre compte activé.
Versionné, téléchargé depuis le portail, empreinte affichée.
Créez une expédition, recevez l'URL de suivi.
Webhooks
Vous créez un abonnement, vous le testez d'un ping, vous lisez l'historique de livraison. Chaque événement part d'une outbox et se relance jusqu'à livraison ; ce qui échoue durablement reste visible en dead-letter.
Périmètre
Créer, lire, suivre ; devis signés et achat d'étiquette.
Événements transporteur, page de suivi publique.
Références, correspondance SKU, position de stock.
Retours avec photos et remise en stock.
Créneaux, points relais, coupons.
EDI X12, PIVOT/EANCOM, réception AS2.
Clés partenaires
Vos clés de compte se créent et se renouvellent depuis le portail développeur. Les clés à portée partenaire — pour un transporteur ou un entrepôt du réseau — sont émises par un administrateur Ysend, avec une portée limitée au compte.
import { YsendClient } from "@ysend/sdk";
const ysend = new YsendClient({ apiKey: process.env.YSEND_API_KEY });
const shipment = await ysend.shipments.create({
orderRef: "SHIP-2026-0501",
parcels: [{ weightKg: 1.2 }],
to: { country: "FR", postalCode: "06700" },
});
console.log(shipment.trackingUrl);Un compte activé donne l'API, le SDK et les webhooks.