Quick Start Guide

Sign up for a free 14-day trial at saleswebhooks.com/register. No credit card required.

After registration, you'll receive:

• Access to the web console
• Your first API key
• 100 entity monitoring quota (Starter plan)

Log into the web console and navigate to Settings → API Keys.

Copy your API key. It should look like:

lwa.sk_live_abcdef123456...

For testing, we'll use webhook.site to receive webhooks:

1. Visit webhook.site
2. Copy your unique URL (e.g., https://webhook.site/550e7388-...)
3. Keep this tab open to see incoming webhooks

Now configure this endpoint in Sales Webhooks:

curl -X POST https://api.saleswebhooks.com/v1/webhooks/configure \
  -H "X-API-Key: lwa.sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint_url": "https://webhook.site/YOUR_UNIQUE_ID",
    "events": ["*"]
  }'

Response:

{
  "id": "whc_8Zx6Li1Ko",
  "endpoint_url": "https://webhook.site/550e7388-...",
  "events": ["*"],
  "secret": "whsec_verySecretKey123",
  "is_active": true,
  "created_at": "2025-01-20T10:30:00Z"
}

Subscribe to a LinkedIn profile to start monitoring:

curl -X POST https://api.saleswebhooks.com/v1/subscriptions \
  -H "X-API-Key: lwa.sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "contact",
    "linkedin_url": "https://linkedin.com/in/williamhgates"
  }'

Response:

{
  "id": "sub_9Yx7Kj2Mn",
  "entity_type": "contact",
  "linkedin_id": "williamhgates",
  "linkedin_url": "https://linkedin.com/in/williamhgates",
  "status": "active",
  "created_at": "2025-01-20T10:30:00Z"
}

You can also subscribe to companies:

curl -X POST https://api.saleswebhooks.com/v1/subscriptions \
  -H "X-API-Key: lwa.sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "entity_type": "company",
    "linkedin_url": "https://linkedin.com/company/microsoft"
  }'

Send a test webhook to verify your endpoint is working:

curl -X POST https://api.saleswebhooks.com/v1/webhooks/test \
  -H "X-API-Key: lwa.sk_live_YOUR_API_KEY"

Check your webhook.site tab. You should see a test event like:

{
  "id": "evt_test_123",
  "type": "test",
  "created": 1705749000,
  "data": {
    "message": "Test webhook from Sales Webhooks"
  }
}

Within 24 hours, you'll start receiving webhooks for any detected changes. Here's an example job change webhook:

{
  "id": "evt_2Xk9Lm3Np",
  "type": "contact.position_changed",
  "created": 1705835400,
  "data": {
    "entity": {
      "id": "sub_9Yx7Kj2Mn",
      "type": "contact",
      "linkedin_id": "jane-smith",
      "linkedin_url": "https://linkedin.com/in/jane-smith"
    },
    "changes": {
      "previous_company": "Acme Corp",
      "previous_title": "Sales Manager",
      "current_company": "TechCo",
      "current_title": "VP of Sales"
    }
  },
  "metadata": {
    "subscription_id": "sub_9Yx7Kj2Mn",
    "detected_at": "2025-01-21T10:30:00Z"
  }
}