LinkedIn API en AI-assistenten (MCP) #

Alles wat je op de LinkedIn-pagina’s doet, kan ook worden uitgevoerd via een script of een AI-assistent: je leads, de wachtrij voor connectieverzoeken, je ICP-regels (inclusief welke landen je accepteert en hoe groot het netwerk van een lead moet zijn), je inbox, je AI-agents en je instellingen.

Er hoeft niets nieuws te worden ingesteld. Het gebruikt dezelfde API-sleutel als de rest van DM Champ, dus als je onze API al aanroept of een AI-assistent hebt gekoppeld, ben je er klaar voor.

Waar vind je je sleutel #

Instellingen → Integraties → API-sleutel. Als je er nog geen hebt, klik dan op API-sleutel genereren. De volledige stappen staan in API-toegang.

Er is geen aparte LinkedIn-sleutel om aan te maken, te roteren of in te trekken. De sleutel fungeert als jij, met dezelfde rechten die je in de app hebt, dus behandel deze als een wachtwoord. Het intrekken ervan in Instellingen verbreekt direct de verbinding met elk gekoppeld script en elke assistent.

De API direct aanroepen #

• Basis-URL: https://app.sdrpilot.ai/api/v1
• Header: X-API-Key: YOUR_API_KEY
• Machineleesbare beschrijving: https://app.sdrpilot.ai/api/v1/docs/openapi.yaml (ook beschikbaar als .json)

Het OpenAPI-document is openbaar en beschrijft elke route, dus de meeste API-tools en codegeneratoren kunnen het direct importeren zonder sleutel.

Authorization: Bearer YOUR_API_KEY werkt ook. Wat je niet kunt doen, is een verkeerde sleutel sturen en hopen dat deze naar iets anders doorverwijst: zodra een sleutel wordt gepresenteerd, is het antwoord gebaseerd op die sleutel.

Wat krijg je terug als er iets mis is:

Een AI-assistent koppelen #

De LinkedIn-tools bevinden zich op hetzelfde MCP-eindpunt als die van DM Champ, met dezelfde API-sleutel, dus een assistent die je al hebt gekoppeld, pikt ze automatisch op. Als je er nog geen hebt gekoppeld, volg dan AI-assistenten koppelen (MCP) en gebruik het eindpunt dat daar wordt vermeld.

De LinkedIn-tools hebben allemaal het voorvoegsel linkedin_, waardoor ze gemakkelijk te herkennen zijn in de toollijst van je assistent en eenvoudig bij naam op te vragen zijn (“gebruik de LinkedIn-tools om me te laten zien wat er in de wachtrij staat”). Er zijn geen machtigingen per tool: een tool kan alles wat jij in de app kunt doen.

Client-werkruimtes en white label #

Wanneer een bureau LinkedIn-outreach doorverkoopt onder het eigen merk, krijgt elke client-werkruimte eigen API-sleutels in plaats van de bovenstaande accountbrede sleutel:

• Sleutels per werkruimte. De klant maakt zijn sleutels aan in de Instellingen van de werkruimte. Een sleutel heeft alleen toegang tot de gegevens van die werkruimte; de eigen pagina’s van het bureau (klanten, branding, facturering) geven een “niet gevonden”-melding als reactie.
• De adressen staan op de instellingenkaart van die werkruimte. Op een branded domein toont de kaart het API-adres op dat domein (https://<your brand domain>/api/v1), het MCP-adres om in een AI-assistent te plakken, en een link naar de helpdocumentatie, alles onder het merk van het bureau.
• De API-toegangsschakelaar van het bureau. Een bureau dat zijn LinkedIn-outreach als een eigen zelfstandig merk beheert, heeft een API-toegang-schakelaar per klant op de Klanten-pagina, die standaard is ingeschakeld. Wanneer deze is uitgeschakeld, worden de sleutels van de klant binnen een minuut geweigerd en verdwijnt de API-kaart uit de instellingen. Het opnieuw inschakelen herstelt dezelfde sleutels. De sleutels van een gepauzeerde klant worden ook geweigerd.

Zie voor de kant van het bureau LinkedIn-outreach doorverkopen aan uw klanten.

Voorbeeld 1 — accepteer alleen leads uit bepaalde landen #

Je ICP-profiel bevat de regels waaraan leads moeten voldoen. Dit stelt een toegestane lijst in van Nederland en België. Landcodes bestaan uit twee hoofdletters.

curl -X PUT https://app.sdrpilot.ai/api/v1/icp/YOUR_ICP_ID/filters \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"countries":{"mode":"allow","codes":["NL","BE"]}}'

Twee dingen om te weten. De body is de volledige set regels, geen patch: een regel die je weglaat, wordt uitgeschakeld. En het antwoord bevat een impact_on_queue-blok dat aangeeft hoeveel reeds in de wachtrij staande verbindingsverzoeken niet zouden voldoen aan de nieuwe regels, bijvoorbeeld {"examined": 389, "would_withdraw": 155}. Zodra ze zijn opgeslagen, worden de nieuwe regels automatisch toegepast op de wachtrij: wachtende verzoeken die er niet aan voldoen, worden ingetrokken.

In een assistent zou je simpelweg zeggen: “Stel mijn ICP in om alleen Nederland en België te accepteren, en vertel me wat dat zou betekenen voor mijn wachtrij.”

Voorbeeld 2 — bekijk wat er in de wachtrij staat #

Connectieverzoeken die zijn goedgekeurd maar nog niet zijn verzonden:

curl -s "https://app.sdrpilot.ai/api/v1/connections/queue?status=queued&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Elke rij bevat de naam van de persoon, de kopregel, het bedrijf, de locatie, het land, het aantal connecties en volgers, en de score. Je kunt de lijst verfijnen met country, min_score, max_score en source, en erdoorheen bladeren met limit en cursor. Alleen verzoeken die in de wachtrij staan of wachten op goedkeuring verschijnen hier. Reeds verzonden verzoeken zijn geschiedenis en kunnen niet worden gewijzigd.

Voorbeeld 3 — trek iedereen buiten je landen in #

Nadat je je regels hebt gewijzigd, controleer je de wachtrij opnieuw aan de hand daarvan. Zonder apply=true is dit een voorbeeld en wordt er niets gewijzigd:

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen" \
  -H "X-API-Key: YOUR_API_KEY"

Je krijgt terug hoeveel er zijn onderzocht, hoeveel er zouden worden ingetrokken, en een overzicht per regel, zoals country en network_too_small (het netwerk van de lead was kleiner dan je minimum). Tevreden? Voer het opnieuw uit met ?apply=true en die verzoeken worden ingetrokken.

curl -X POST "https://app.sdrpilot.ai/api/v1/connections/queue/rescreen?apply=true" \
  -H "X-API-Key: YOUR_API_KEY"

Als je liever een specifieke set intrekt, post dan de ids, of een filter zoals {"filter":{"status":"queued","country":"NG"}} om alles wat overeenkomt te verwijderen. Stuur ids of een filter, niet beide.

Probleemoplossing #

• 401 bij elke aanroep — de sleutel ontbreekt of is onjuist. Kopieer deze opnieuw vanuit Instellingen → Integraties → API-sleutel.
• 403 hoewel de sleutel elders werkt — dat account is niet gekoppeld aan een LinkedIn-werkruimte, of LinkedIn is er nog niet voor ingeschakeld.
• 502 dmchamp_unreachable — een tijdelijke hapering bij het controleren van je sleutel. Er is niets doorgelaten; probeer het opnieuw.
• Een regel komt nergens mee overeen — landcodes moeten de tweeletterige hoofdlettervorm zijn (NL, niet Netherlands of nl), en taalcodes moeten kleine letters zijn.
• De assistent toont geen LinkedIn-tools — koppel deze opnieuw zodat de toollijst wordt herladen, en controleer of je dezelfde API-sleutel gebruikt.

Volgende stappen #

• AI-assistenten verbinden (MCP) — stel Claude of Cursor in met je sleutel.
• API-toegang — genereer of roteer de sleutel die hiervoor wordt gebruikt.