---
title: Utiliser l'API JeudiMerci
description: "Vous souhaitez envoyer de façon automatisée des cadeaux à des destinataires remplissant certains critères ?\n\nC'est possible grâce à notre API !"
---

[Passer au contenu](https://help.jeudimerci.fr/knowledge/utiliser-lapi#main-content)

Français

Afficher le sous-menu pour les traductions

![Property 1=Logo - Noir (1)](https://help.jeudimerci.fr/hs-fs/hubfs/Property%201=Logo%20-%20Noir%20(1).png?width=250&height=44&name=Property%201=Logo%20-%20Noir%20(1).png)

Ouvrir la navigation principale

Fermer la navigation principale

- Français
  
  Afficher le sous-menu pour les traductions
- [Accéder à app.jeudimerci.fr](https://app.jeudimerci.fr/en/#/account/user/profile)

[Accéder à app.jeudimerci.fr](https://app.jeudimerci.fr/en/#/account/user/profile)

 Bonjour 👋 Comment pouvons-nous vous aider ?

- Il n'y a aucune suggestion car le champ de recherche est vide.

1. [Help Center](https://help.jeudimerci.fr/knowledge?hsLang=fr)
2. [Intégrations](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr)
3. [API publique](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#api-publique)

# Utiliser l'API JeudiMerci

## Vous souhaitez envoyer de façon automatisée des cadeaux à des destinataires remplissant certains critères ? C'est possible grâce à notre API !

### Documentation de l'API

La documentation de l'API se trouve dans la section "Automatisation" de votre espace JeudiMerci.

### POST: déclencher l'envoi d'un cadeau

Cette requête vous permet de passer une commande et retourne une réponse indiquant la bonne exécution, ainsi que l'ID de la commande créée.

#### Vos identifiants

Pour envoyer une requête, vous devez vous identifier:

- Identifier votre entreprise grâce à votre companyId.
- Identifier l'utilisateur qui passe la commande grâce à votre userId. Cet UserID est important pour vous offrir une visibilité claire sur les cadeaux envoyés par chaque membre de l'équipe.

#### Le destinataire

Vous devez ensuite indiquer des informations sur le destinataire:

**deliveryAddress**: l'adresse de livraison du cadeau.  
Ce champs est optionnel - si vous choisissez l'option "DeliveryWithoutAddress", nous n'avons pas besoin de connaître l'adresse de livraison à priori.

#### Le cadeau

- **giftId** : c'est la référence du cadeau que vous souhaitez envoyer.   
  Celle-ci est disponible dans la description de chaque cadeau, dans votre catalogue.
- **quantity**: c'est le nombre de cadeaux que vous souhaitez envoyer. Comme il est rare d'envoyer plusieurs fois le même cadeau à un seul destinataire, le champ n'est pas obligatoire et automatiquement considéré comme valant 1.

#### Options de livraison

- - **Livraison sans adresse**  
      Vous ne connaissez pas l'adresse de livraison ? Choisissez **optionsDeliveryWithoutAddress**: un email sera envoyé automatiquement au destinataire pour qu'il/elle choisisse où se faire livrer.
      
      Ce champ comporte 3 options :

- - - deliveryWithoutAddress : précise si cette option est sélectionnée ou non. Ce champ est obligatoire.
          - emailAlibiExpeditor : le nom de la personne qui offre le cadeau. Ce champ n'est pas obligatoire mais vivement conseillé ; il donne du contexte à votre destinataire, et l'incite à donner son adresse.
          - emailAlibiContent : une petite phrase expliquant POURQUOI vous envoyez ce cadeau. Ce champ n'est pas obligatoire mais vivement conseillé : il donne du contexte à votre destinataire, et l'incite à donner son adresse.
    - **Confirmation d'adresse**  
      Vous avez une adresse postale, mais n'êtes pas sûr·e que ce soit la bonne ? Laissez à votre destinataire la possibilité de la modifier ! Choisissez **optionsAddressConfirmation**, et nous contactons le destinataire par mail afin qu'il puisse confirmer ou modifier son adresse de livraison.
      
      Ce champ comporte quatre informations : 
          - confirmation : précise si cette option est séléctionnée ou non. Ce champ est obligatoire.
          - emailAlibiExpeditor : le nom de la personne qui offre le cadeau. Ce champ n'est pas obligatoire mais vivement conseillé: il donne du contexte à votre destinataire, et l'incite à donner son adresse.
          - emailAlibiContent :
          - une petite phrase expliquant POURQUOI vous envoyez ce cadeau. Ce champ n'est pas obligatoire mais vivement conseillé: il donne du contexte à votre destinataire, et l'incite à donner son adresse.
          - sendAnyway : Ce champ indique si la commande doit être envoyée si le destinataire n'a pas confirmé son adresse dans le délai imparti. Si l'option de confirmation d'adresse est sélectionnée, ce champ est obligatoire.

#### Confirmation de commande

Le champs *optionsEmailConfirmation* vous permet de choisir si un email de confirmation doit être envoyé à votre équipe à chaque fois qu'un cadeau est commandé. Ce champ n'est pas obligatoire et vaut faux par défaut.

 

---

*Vous ne trouvez pas de réponses à vos questions ? Ecrivez nous sur [support@jeudimerci.fr](mailto:support@jeudimerci.fr).*

- [Vous découvrez JeudiMerci ?](https://help.jeudimerci.fr/knowledge/vous-d%C3%A9couvrez-jeudimerci?hsLang=fr)
- [La plateforme](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#main-content)

    - [Campagnes](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#campagnes)
    - [Modèles](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#mod%C3%A8les)
    - [Message personnalisé](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#message-personnalis%C3%A9)
    - [Simulateur d'envois](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#simulateur-denvois)
    - [Boutique](https://help.jeudimerci.fr/knowledge/la-plateforme?hsLang=fr#boutique)
- [Produits personnalisés](https://help.jeudimerci.fr/knowledge/produits-personnalis%C3%A9s?hsLang=fr)
- [Intégrations](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#main-content)

    - [Hubspot](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#hubspot)
    - [Salesforce](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#salesforce)
    - [Zapier](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#zapier)
    - [API publique](https://help.jeudimerci.fr/knowledge/int%C3%A9grations?hsLang=fr#api-publique)
- [Paramètres du compte](https://help.jeudimerci.fr/knowledge/param%C3%A8tres-du-compte?hsLang=fr#main-content)

    - [Equipe et utilisateur](https://help.jeudimerci.fr/knowledge/param%C3%A8tres-du-compte?hsLang=fr#equipe-et-utilisateur)
    - [Budget et paiement](https://help.jeudimerci.fr/knowledge/param%C3%A8tres-du-compte?hsLang=fr#budget-et-paiement)
    - [Club ambassadeur](https://help.jeudimerci.fr/knowledge/param%C3%A8tres-du-compte?hsLang=fr#club-ambassadeur)
- [Inventaire et entrepôt](https://help.jeudimerci.fr/knowledge/inventaire-et-entrep%C3%B4t?hsLang=fr)
- [La carte JeudiMerci](https://help.jeudimerci.fr/knowledge/la-carte-jeudimerci?hsLang=fr)

[![](https://help.jeudimerci.fr/hs-fs/hubfs/LogoComplet_Original%20(1).webp?width=300&height=100&name=LogoComplet_Original%20(1).webp)](https://www.jeudimerci.fr)

Help Center JeudiMerci

Copyright © 2026, JeudiMerci