Clé API Sirene (INSEE)

L’API Sirene de l’INSEE est la source officielle sur l’identité des entreprises françaises (SIREN, SIRET, adresse, activité, forme juridique). Elle est gratuite, mais chaque organisation doit avoir sa propre clé. Une clé donne droit à 30 requêtes par minute, sans plafond journalier.

Il vous faut une adresse e-mail professionnelle et un accès administrateur à votre org Salesforce. Comptez dix minutes.

1. Créer votre compte sur le portail de l’INSEE

1. Ouvrez le portail des API de l’INSEE.
2. Cliquez sur Se connecter, puis sur CONNEXION-POUR-LES-EXTERNES.
3. Première visite : cliquez sur Enregistrement, remplissez le formulaire et validez.
4. L’INSEE vous envoie un e-mail depuis portail-api@insee.fr. Cliquez sur le lien qu’il contient pour confirmer votre adresse (pensez à regarder dans les indésirables).
5. Revenez sur le portail : Se connecter > CONNEXION-POUR-LES-EXTERNES, saisissez vos identifiants, puis Connexion.

Une adresse d’équipe

Créez le compte avec une adresse partagée, par exemple admin-salesforce@votre-societe.fr, plutôt qu’une adresse personnelle : la clé restera accessible si la personne quitte l’entreprise.

Mot de passe du portail

Depuis septembre 2026, l’INSEE demande de renouveler le mot de passe du portail tous les 90 jours. Cela ne concerne que la connexion au portail : la clé continue de fonctionner et n’a pas de date d’expiration.

2. Créer une application

Pour l’INSEE, une « application » est simplement le conteneur de votre clé.

1. Dans le menu du haut, ouvrez Tableau de bord.
2. Cliquez sur Créer ma première application (ou Créer une application si vous en avez déjà une).
3. Renseignez :
   • Nom : par exemple Salesforce - Acta ;
   • Description : par exemple Enrichissement des comptes et prospects dans Salesforce ;
   • Domaine (conseillé) : l’adresse de votre org, par exemple votre-societe.my.salesforce.com.
4. Choisissez le mode de création simple.
5. Laissez la page de souscription vide, puis cliquez sur CRÉER L’APPLICATION dans le récapitulatif.

3. Souscrire à l’API Sirene

1. Dans le menu du haut, ouvrez Catalogue, puis API Sirene.
2. Cliquez sur Souscrire.
3. Choisissez le plan Public (le seul proposé, gratuit), puis Suivant.
4. Sélectionnez l’application créée à l’étape 2 et validez.

La souscription est immédiate, sans validation manuelle par l’INSEE.

4. Copier la clé

1. Ouvrez votre application depuis le Tableau de bord.
2. Onglet Souscriptions : cliquez sur la souscription API Sirene.
3. La clé s’affiche à droite. Cliquez sur l’icône de copie à côté.

La clé ressemble à une longue suite de lettres et de chiffres séparés par des tirets (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Gardez-la comme un mot de passe : ne l’envoyez ni par e-mail ni dans une conversation.

Facultatif : vérifier la clé sur le portail

Dans API Sirene, onglet Documentation, menu Swagger à gauche : cliquez sur Authorize, collez la clé, Authorize. Choisissez par exemple le service « siren/{siren} », Try it out, saisissez un SIREN et Execute. Un code 200 confirme que la clé fonctionne.

5. Saisir la clé dans Salesforce

1. Ouvrez l’application Acta, onglet Configuration Acta, section 2. Clé INSEE.
2. Collez la clé dans Clé d’API Sirene, puis cliquez sur Enregistrer la clé.
3. Cliquez sur Tester : Acta interroge l’INSEE et affiche le résultat.

La clé est enregistrée chiffrée et envoyée à l’INSEE dans l’en-tête X-INSEE-Api-Key-Integration. Personne ne peut la relire dans Salesforce, pas même un administrateur. Vos utilisateurs y ont accès, sans la voir, grâce aux jeux d’autorisations Enrichissement légal - Utilisateur et Enrichissement légal - Administrateur.

Sans la page Configuration

La clé peut aussi être saisie à la main : Configuration > Identifiants nommés > onglet Informations d’identification externes > Sirene (INSEE). Sur la ligne Principal de la section Principaux, choisissez Modifier, puis Ajouter un paramètre d’authentification : nom ApiKey (exactement ainsi, la casse compte), valeur la clé. Enregistrez.

6. Vérifier

Lancez un premier enrichissement sur un compte qui a un SIREN ou un SIRET. Si la fiche indique Sirene comme source, tout fonctionne. Si elle indique RechercheEntreprises, Acta est passé par la source de secours : voir le dépannage ci-dessous.

Remettre Sirene en service après avoir saisi la clé

Si Acta a déjà essayé Sirene sans clé, la source a été mise de côté après 3 échecs : c’est le cas dans l’org de démonstration. Elle revient seule au bout de 10 minutes. Pour l’essayer tout de suite, voir Remettre une source en service.

Dépannage

Ce que vous voyez	Cause probable et solution
Le test renvoie « clé invalide » ou une erreur 401	Clé mal copiée (espace en trop au début ou à la fin), ou souscription à l’API Sirene oubliée (étape 3). Recopiez la clé depuis l’onglet Souscriptions
Erreur « We couldn’t access the credential »	L’utilisateur n’a pas de jeu d’autorisations Enrichissement légal, qui donne accès à la clé
La fiche indique RechercheEntreprises alors que la clé est saisie	Sirene a été mise de côté après 3 échecs, avant la clé par exemple. Elle revient seule au bout de 10 minutes, ou tout de suite par Remettre en service dans Configuration Acta, section 4. Sources
Erreur 429 (trop de requêtes)	Plus de 30 requêtes par minute sur la clé. Acta réessaie seul plus tard ; pour de gros volumes, étalez les traitements
Paramètre saisi à la main mais ignoré	Nom différent de ApiKey (la casse compte), ou paramètre ajouté sur le mauvais identifiant
Mot de passe du portail expiré	Renouvelez-le sur le portail. La clé n’est pas concernée et continue de fonctionner

Révoquer une clé

Après le départ d’un prestataire ou une fuite : sur le portail, ouvrez l’application, puis la souscription API Sirene, et renouvelez ou révoquez la clé. Saisissez ensuite la nouvelle clé dans Salesforce (étape 5).

Sans clé

Tant que vous n’avez pas de clé, désactivez la source Sirene : Acta interrogera directement l’API Recherche d’entreprises, sans perdre de temps sur un appel voué à l’échec. Dans Configuration Acta, section 2. Clé INSEE, cliquez sur Désactiver Sirene. Le même bouton la réactive quand vous aurez la clé.

L’API Recherche d’entreprises fournit l’essentiel (dénomination, adresse du siège, NAF, forme juridique), mais elle est limitée par adresse IP, partagée entre tous les clients Salesforce de votre instance. Elle convient au démarrage et à la recherche interactive, moins aux enrichissements en masse.

---

Parcours vérifié le 10 octobre 2026 d’après la procédure officielle de l’INSEE (modalités de connexion à l’API publique). Les libellés du portail peuvent évoluer : au final, il faut une clé d’application souscrite à l’API Sirene, plan Public.