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.

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 geplaatste connectieverzoeken niet aan de nieuwe regels zouden voldoen, bijvoorbeeld {"examined": 389, "would_withdraw": 155}. Het opslaan van regels trekt op zichzelf niets in.

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, ChatGPT of Cursor in met je sleutel.
• API-toegang — genereer of roteer de sleutel die hiervoor wordt gebruikt.