Infonet REST API

Infonet exposes a full REST API for every action a customer can take in the dashboard, plus webhooks for every event. Build custom integrations, automate operational workflows, or wire Infonet into your own product.

What you can do with the API

Quick start

Authentication uses bearer tokens generated from the workspace settings. All endpoints accept and return JSON over HTTPS.

# Get a prospect by LinkedIn URL
curl https://api.infonet.co/v1/prospects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -G --data-urlencode "linkedin_url=https://linkedin.com/in/johndoe"

# Add a prospect to a campaign
curl https://api.infonet.co/v1/campaigns/CAMPAIGN_ID/prospects \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin_url": "https://linkedin.com/in/johndoe", "context": "Recently raised Series B"}'

# Generate an AI-personalized opener
curl https://api.infonet.co/v1/ai/opener \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"prospect_url": "https://linkedin.com/in/johndoe", "voice_library_id": "vl_xxx"}'

Webhooks

Configure webhook endpoints from the workspace settings. Each webhook payload is signed with HMAC-SHA256; verify the signature before processing.

# Sample webhook payload (reply received)
{
  "event": "message.reply_received",
  "timestamp": "2026-05-09T10:23:45Z",
  "workspace_id": "ws_xxx",
  "data": {
    "prospect_id": "p_xxx",
    "campaign_id": "c_xxx",
    "channel": "linkedin",
    "sentiment": "positive",
    "reply_text": "...",
    "thread_id": "t_xxx"
  }
}

SDKs

Official SDKs available for Python, Node.js, Go, and Ruby. Auto-generated from the OpenAPI spec; updated within 24 hours of any API change.

• Python: pip install infonet
• Node.js: npm install @infonet/sdk
• Go: go get github.com/infonet/infonet-go
• Ruby: gem install infonet

Rate limits

• Pro tier: 100 requests/minute, 10,000 requests/day per workspace
• Agency tier: 500 requests/minute, 100,000 requests/day per workspace
• Enterprise tier: Custom limits, available on request

Rate-limit headers (X-RateLimit-Remaining, X-RateLimit-Reset) on every response. Exceeding the limit returns 429 Too Many Requests.

Pagination

List endpoints use cursor-based pagination. Response includes next_cursor; pass it as the cursor query parameter on the next request.

Errors

Standard HTTP status codes. Detailed error responses in JSON:

{
  "error": {
    "code": "prospect_not_found",
    "message": "No prospect matches the provided LinkedIn URL.",
    "details": { "linkedin_url": "https://linkedin.com/in/johndoe" }
  }
}

Versioning

API version is set via the URL path (/v1/). Backwards-incompatible changes go to a new version with at least 12 months of overlap. Subscribe to api-changes@infonet.co for deprecation notices.

Common integration patterns

Webhook → Slack notification

Subscribe to message.reply_received with positive sentiment, post to a Slack channel for real-time SDR/AE notification. Many customers do this via the native Slack integration; the API is for custom routing logic.

CRM enrichment loop

Daily cron pulls accepted-connection prospects from Infonet, enriches via your CRM's API, pushes back enriched fields to Infonet for AI personalization to reference. Useful for teams running deep custom enrichment pipelines.

Lead scoring

Subscribe to all reply events, score prospects against your custom lead model (intent, fit, recency), update their priority field in Infonet via API. Higher-priority prospects automatically jump to top of queue.

Embedded outreach in your product

Some Infonet customers build their own product on top of Infonet's API — offering LinkedIn outreach as a feature inside their own SaaS. Talk to us about this; there's an OEM tier available.

Documentation

Full API reference at docs.infonet.co/api. Includes every endpoint, request/response examples, error codes, and an interactive API explorer for paid customers.

Support

Developer support via email at api@infonet.co. Average response time: 4 business hours. For Enterprise customers, dedicated Slack support channel.