Comment créer un signal Rodz et l'envoyer vers lemlist, entièrement par l'API ?

Avant de commencer

• Une clé API Rodz (Intégrations → API dans le tableau de bord), exportée dans RODZ_API_KEY.
• Une clé API lemlist et une campagne lemlist avec au moins une étape.
• curl et, pour lire les réponses plus facilement, jq.

Étapes

1. Étape 1. Choisissez le type de signal et ses valeurs autorisées

   GET /api/v1/signal-types est le point d'entrée : chaque type y donne son createEndpoint, ses configParameters, son pricingModel et ses outputFields. Pour les changements de poste, les fonctions viennent de GET /api/v1/personas (le champ name) et les secteurs de GET /api/v1/signals/industries (à recopier tels quels : la correspondance est exacte).

   Catalogue, personas et secteurs

   curl -s "https://api.rodz.io/api/v1/signal-types" -H "Authorization: Bearer $RODZ_API_KEY" \
     | jq '.signalTypes[] | {signalTypeId, createEndpoint, creditsPerLead}'
   curl -s "https://api.rodz.io/api/v1/personas" -H "Authorization: Bearer $RODZ_API_KEY"
   curl -s -G "https://api.rodz.io/api/v1/signals/industries" -H "Authorization: Bearer $RODZ_API_KEY" \
     --data-urlencode "search=software"

2. Étape 2. Créez le signal en brouillon

   Envoyez name, config, dailyLeadLimit et duplicateHandling. Sans status, le signal est créé en draft. Activez getEmails : une séquence email a besoin de l'adresse.

   La réponse 201 renvoie le signal avec deux champs à lire : applied (les réglages réellement appliqués quand ils diffèrent de config) et warnings (les valeurs de filtre probablement erronées). Ce ne sont jamais des erreurs : le signal est créé quoi qu'il arrive.

   POST /api/v1/signals/job-changes

   curl -s -X POST "https://api.rodz.io/api/v1/signals/job-changes" \
     -H "Authorization: Bearer $RODZ_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "name": "Nouveaux directeurs commerciaux SaaS France",
       "dailyLeadLimit": 30,
       "duplicateHandling": "refuse",
       "config": {
         "jobTitles": ["Sales Director"],
         "customTitles": ["Head of Revenue"],
         "companySizeFilters": ["51-200", "201-500"],
         "industryFilters": ["Software Development"],
         "locations": ["France"],
         "getEmails": true
       }
     }' | tee signal.json
   export SIGNAL_ID=$(jq -r .id signal.json)

3. Étape 3. Connectez lemlist

   PUT /api/v1/integrations/lemlist enregistre votre clé lemlist ; elle est vérifiée avant d'être stockée, puis chiffrée. GET /api/v1/integrations montre ensuite connected: true. HubSpot, Pipedrive et Google Sheets se connectent une fois par OAuth dans le tableau de bord (l'API répond 400 USE_DASHBOARD_OAUTH).

   PUT /api/v1/integrations/lemlist

   curl -s -X PUT "https://api.rodz.io/api/v1/integrations/lemlist" \
     -H "Authorization: Bearer $RODZ_API_KEY" \
     -H "Content-Type: application/json" \
     -d "{\"apiKey\": \"$LEMLIST_API_KEY\", \"label\": \"Équipe commerciale\"}"

4. Étape 4. Récupérez l'identifiant de la campagne

   GET /api/v1/integrations/lemlist/campaigns renvoie items[] avec id, name et status. L'id est le campaignId de l'étape suivante. Un 409 signifie que lemlist n'est pas connecté.

   GET /api/v1/integrations/lemlist/campaigns

   curl -s "https://api.rodz.io/api/v1/integrations/lemlist/campaigns" \
     -H "Authorization: Bearer $RODZ_API_KEY" | jq '.items[] | {id, name, status}'

5. Étape 5. Routez le signal vers la campagne, puis activez-le

   Un PATCH avec destinations.lemlist.campaignId branche le signal sur la campagne. Si plusieurs comptes lemlist sont connectés, ajoutez integrationId. Un second PATCH passe le signal en active : à partir de là, chaque lead livré est facturé et poussé dans la campagne.

   PATCH /api/v1/signals/{signal_id}

   curl -s -X PATCH "https://api.rodz.io/api/v1/signals/$SIGNAL_ID" \
     -H "Authorization: Bearer $RODZ_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"destinations": {"lemlist": {"campaignId": "cam_aBc123XyZ"}}}'
   
   curl -s -X PATCH "https://api.rodz.io/api/v1/signals/$SIGNAL_ID" \
     -H "Authorization: Bearer $RODZ_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"status": "active"}'

Exemple de payload

Réponse `201 Created` de `POST /api/v1/signals/job-changes` (données fictives). `applied` vide = tout est appliqué tel qu'enregistré.

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Nouveaux directeurs commerciaux SaaS France",
  "status": "draft",
  "signalTypeId": "job_changes",
  "webhookUrl": null,
  "config": {
    "jobTitles": ["Sales Director"],
    "customTitles": ["Head of Revenue"],
    "companySizeFilters": ["51-200", "201-500"],
    "industryFilters": ["Software Development"],
    "locations": ["France"],
    "getEmails": true
  },
  "dailyLeadLimit": 30,
  "leadsToday": 0,
  "leadsTotal": 0,
  "duplicateHandling": "refuse",
  "createdAt": "2026-10-12T08:00:00Z",
  "updatedAt": "2026-10-12T08:00:00Z",
  "lastLeadAt": null,
  "applied": {},
  "warnings": []
}

Questions fréquentes

Sources

• Référence de l’API Rodz : Create Job Changes signal, Update signal, Integrations
• Spécification OpenAPI de l’API Rodz

Guides associés

• Recette API Comment récupérer les leads d'un signal Rodz par l'API, sans webhook ?
• Recette API Comment recevoir les leads Rodz par webhook et vérifier leur signature HMAC ?
• Recette Comment lancer une séquence lemlist quand un prospect change de poste ?
• À propos de ce signal Changements de poste