company logo

Help center

Go to SendCopy
Product TourPricing OverviewAbout SendCopyJoin CommunityPartner Program
All collectionsIntegrations & APIWebhooks: Setup & Payload Reference

Webhooks: Setup & Payload Reference

Learn how to set up SendCopy.ai webhooks, choose supported events and campaigns, configure custom headers, and handle webhook JSON payloads in your application.

Webhooks let SendCopy automatically send information to another system when a specific event happens in your account.

You can use webhooks to send SendCopy activity to a CRM, automation platform, Slack workflow, or your own application.

Basic flow:

SendCopy → Webhook URL → Your Application / Automation Tool

Webhooks send data using HTTPS and JSON.

Supported Webhook Events

SendCopy currently supports these events:

  1. Connection Request Sent - A new LinkedIn connection request is sent.

  2. Connection Request Accepted - A prospect accepts your connection request.

  3. Message Sent - A campaign message is sent to a connected lead.

  4. InMail Sent - An InMail is sent to a lead outside your network.

  5. First Message Reply Received - A prospect replies to a message for the first time.

  6. First InMail Reply Received - A prospect replies to an InMail for the first time.

  7. Follow Sent - SendCopy follows a prospect's profile.

  8. Liked Post - SendCopy likes a prospect's post as part of a sequence.

  9. Viewed Profile - SendCopy views a prospect's profile as part of a sequence.

Each webhook listens for one event. If you want to receive multiple event types, create a separate webhook for each event.

How to Set Up a Webhook

  1. Go to Settings → Integrations in SendCopy.

  2. Open the Webhook integration.

  3. Click Create a webhook.

  4. Enter a name for the webhook.

  5. Enter your destination URL.

  6. Select the event type you want to receive.

  7. Select the campaign or campaigns the webhook should apply to.

  8. Add custom headers if your endpoint requires authentication.

  9. Save the webhook.

Once saved, the webhook becomes active, and SendCopy can begin delivering matching events to your endpoint.

Webhook Request

SendCopy sends webhook data as an HTTP POST request to your configured URL.

Your endpoint should be prepared to receive and process a JSON request body.

Example:

{
  "event": "connection_request.accepted",
  "timestamp": "2023-08-09T09:41:12Z",
  "campaign": "Q3 SaaS Outreach",
  "lead": {
    "name": "Sarah Mitchell",
    "title": "VP Sales",
    "company": "Stripe"
  }
}

The exact fields can vary depending on the event. Your application should therefore avoid assuming that every possible field will always be present.

Custom Headers

If your webhook endpoint requires authentication or additional request information, you can add custom headers when creating the webhook.

For example:

Authorization: Bearer YOUR_TOKEN

SendCopy supports up to five custom headers per webhook.

Campaigns

When creating a webhook, you can choose which campaigns it applies to.

For example, you could configure a webhook to:

  • Receive events from all campaigns, or

  • Receive events only from selected campaigns.

This lets you send specific campaign activity to different systems or workflows.

Handling Webhook Data

Your application should safely process incoming webhook requests and validate the information it needs.

Depending on the event, useful information may include:

  • Event type

  • Timestamp

  • Campaign

  • Lead information

  • Event-specific activity or status information

Do not assume every event contains the same fields. Build your integration so that missing or newly added fields do not cause it to fail.

Delivery and Troubleshooting

SendCopy's webhook system uses HTTPS and includes delivery retry and logging capabilities.

During development, log incoming webhook requests so you can inspect:

  • Request headers

  • Event type

  • JSON payload

  • HTTP response status

  • Any validation or processing errors

Make sure your endpoint returns an appropriate successful HTTP response after processing a valid webhook.

If your endpoint is not receiving events, first check the webhook URL, selected event, campaign configuration, endpoint availability, and your server logs.

Tips

↳ Use a dedicated endpoint for each webhook when you need different processing logic.

↳ Validate incoming data before using it in your CRM or automation workflow.

↳ Store the event timestamp and event type for troubleshooting and audit purposes.

↳ Handle missing fields gracefully.

↳ Use HTTPS for your webhook endpoint.

↳ Log webhook requests while developing your integration, then reduce sensitive logging in production.

Related Articles

  • Overview of Available Integrations

  • Zapier Integration Guide

  • Clay Integration Guide

Did this answer your question?
😞
😐
😁