Sending connection invitations

Use send_invitation to connect with someone on LinkedIn. The profile_url parameter is flexible despite its name: pass a provider ID (best, straight from search results), a profile slug, or a full LinkedIn URL.

You can attach a personal message of up to 300 characters. Personalized notes get meaningfully higher acceptance rates than generic ones. One caveat: free LinkedIn accounts only get a limited number of personalized notes per month. If you hit that limit, invitations still go out, just without the note.

Before sending, Crispy runs pre-flight checks so you never waste an action:

• Already connected? You get already_connected back with a hint to use send_message instead.
• Invitation already pending? You get already_pending with the original send date. No duplicate is sent.
• On your block list? The send is refused with a blacklisted error.

Invitations are capped at 15 per day by default (warm-up mode ramps this up gradually for new accounts) and the counter resets at midnight UTC. Pass a campaign_id to attribute the invitation to a campaign for clean reporting.

Manage your pending queue with list_invitations (use direction sent and status pending to see your outbound requests) and cancel_invitation to withdraw one that has gone stale. Withdrawing old requests keeps your pending count healthy. A withdrawal fails cleanly if the person already accepted.

Pro tip: only include a note when you can make it genuinely specific to the person. A blank invitation reliably outperforms a generic template note, because a generic note reads as a pitch. If you can reference their actual work in one sentence, the note wins. If you can't, send it blank.