Créer un token API et faire votre première requête

L'API publique de Swimlane permet à vos scripts, à n8n ou à Make de lire et de modifier vos contacts, listes, tags et pipelines. Ce guide crée un token et lance une première requête en moins de cinq minutes.

Avant de commencer

Il faut un accès à Swimlane (un abonnement actif sur votre organisation) pour créer un token.
Ouvrez au moins une fois dans l'application l'organisation sur laquelle l'API doit travailler. Un token agit toujours sur l'organisation que vous avez utilisée en dernier (voir Passer d'une organisation à l'autre).

Créer un token

Cliquez sur Paramètres en bas de la barre latérale gauche.
Dans le groupe Intégrations, ouvrez API.
Dans la carte Jetons API, cliquez sur Ajouter un jeton.
Donnez-lui un Nom du token qui indique où il servira, par exemple « n8n – synchro HubSpot ».
Cliquez sur Créer le token.
Copiez le Token généré avec le bouton de copie. Il commence par wpa_.
Cliquez sur Terminé.

Le token complet ne s'affiche qu'une seule fois. Rangez-le dans un gestionnaire de mots de passe ou dans les identifiants de votre outil d'automatisation. Si vous le perdez, supprimez-le et créez-en un nouveau.

Faire votre première requête

L'API est disponible sur https://api.getswimlane.com et chaque endpoint commence par /v1. Envoyez votre token dans l'en-tête Authorization :

curl "https://api.getswimlane.com/v1/contacts?per_page=2" \
  -H "Authorization: Bearer wpa_votre_token"

Vous obtenez les contacts les plus récents de votre organisation, du plus récent au plus ancien :

{
  "meta": {
    "total": 1284,
    "perPage": 2,
    "currentPage": 1,
    "lastPage": 642,
    "firstPage": 1,
    "firstPageUrl": "/?page=1",
    "lastPageUrl": "/?page=642",
    "nextPageUrl": "/?page=2",
    "previousPageUrl": null
  },
  "data": [
    {
      "uuid": "3f0c5b1e-8d2a-4c1e-9f5b-2a7d6e1c9b40",
      "firstName": "Julie",
      "lastName": "Martin",
      "email": null,
      "headline": "Directrice commerciale chez Acme",
      "location": "Lyon, France",
      "linkedinId": "julie-martin-42",
      "archived": false,
      "listUuids": ["b8e2…"],
      "companyUuids": ["41aa…"],
      "tagIds": [12],
      "pipelineStageUuid": null,
      "createdAt": "2026-09-01T08:15:22.000+00:00",
      "updatedAt": "2026-09-12T16:40:03.000+00:00"
    }
  ]
}

Un contact contient quelques champs de plus que ceux montrés ici : la liste complète se trouve dans Référence de l'API publique Swimlane.

Essayez ensuite une écriture, par exemple la création d'une liste :

curl -X POST "https://api.getswimlane.com/v1/lists" \
  -H "Authorization: Bearer wpa_votre_token" \
  -H "Content-Type: application/json" \
  -d '{"name": "Participants webinar"}'

Explorer tous les endpoints

La documentation interactive se trouve sur https://api.getswimlane.com/docs. Cliquez sur Authorize, collez votre token : vous pouvez lancer les requêtes depuis la page.

Suivre votre utilisation de l'API

De retour dans Paramètres → API, la carte API Usage (libellé en anglais) liste vos derniers appels avec la méthode, le chemin, le code de statut, la durée et la date. C'est le moyen le plus rapide de comprendre pourquoi une automatisation échoue.

Bon à savoir

Limite de débit : 100 requêtes par minute par utilisateur Swimlane, tous vos tokens confondus. Chaque réponse indique où vous en êtes avec les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset (horodatage Unix en secondes). Au-delà, vous recevez un 429 avec rate_limit.exceeded.
Pagination : page et per_page sur les endpoints de liste. per_page vaut 50 par défaut, 100 au maximum.
Un token est valable quatre ans, puis expire. Pour le révoquer avant, cliquez sur l'icône corbeille à côté de lui dans Jetons API : il est supprimé immédiatement, sans confirmation.
Seuls les tokens créés dans Paramètres → API fonctionnent. Ils sont liés à vous : chaque membre de l'équipe qui a besoin de l'API crée le sien.
Les modifications faites via l'API ne déclenchent pas de webhooks. Les événements webhook proviennent des actions dans l'application et des imports de Swimlane.

Dépannage

401 « Invalid or missing API token » : l'en-tête manque, le token a été supprimé ou a expiré, ou ce n'est pas un token wpa_.
403 organization.required : votre compte n'a aucune organisation sélectionnée. Connectez-vous à l'application, ouvrez votre organisation, puis réessayez.
404 resource.not_found : l'uuid n'existe pas dans l'organisation sur laquelle agit le token. Vérifiez que vous avez utilisé la bonne organisation en dernier dans l'application.
422 validation.failed : le corps de la requête est invalide ; le tableau errors indique le champ en cause.