Building an Action Integration for Website Intelligence

Last updated: September 11, 2026

Important: It is against Vector's Acceptable Use Policy to white-label Vector, Website Intelligence, or any Vector product or feature without a Partnership Agreement.

⚡ Powered by Vector

Vector's Website Intelligence helps teams understand the people and companies visiting their website and the activity happening across those visits.

With an Action Integration, you can make that Vector data available inside your own product. Mutual customers can configure your integration as an Action in a Vector Segment, allowing qualifying activity to be sent directly to your application.

Common Use Case

  • You have: A product used by marketing or sales teams.

  • You want: To give your users contact- or account-level insights about their website visitors.

  • Vector provides: The Website Intelligence and Segment workflow that identifies qualifying activity and sends it to your application.

How It Works

  1. Your customer creates a Vector account and installs the Vector Pixel on their website.

  2. Your customer configures your integration in Vector using a webhook URL you provide.

  3. Your integration becomes available as an Action in the Vector Segment builder.

  4. When qualifying activity enters the Segment, Vector sends the corresponding event to your webhook.

Implementation Steps

1. Create a Vector Account

Create a Vector account and install the Vector Pixel on a website. You'll use this as the test account for your integration.

It's easiest to use an account connected to a real website so you can generate enough Website Intelligence activity to test your integration.

2. Build and Deploy a Webhook Endpoint

Your endpoint should be able to receive the contact.visited event.

We recommend giving each customer a separate webhook endpoint. One way to accomplish this is by using a path parameter.

Here's an example contact.visited payload:

{
  "company": "Vector",
  "companyDomain": "https://vector.co",
  "email": "joshua@vector.co",
  "externalId": "eidtest",
  "firstName": "Joshua",
  "hem": "1dad25f70ec4ccc5e2e4d878765beb32f8c5ea935c5ab89571d2cf4c1815c0e2",
  "lastName": "Perk",
  "lastVisitAt": "2024-11-19T17:41:59.483Z",
  "linkedinUrl": "https://linkedin.com/in/joshuaperk",
  "location": "Oakland, CA",
  "pageTitle": "Vector - Contact-based marketing",
  "pageUrl": "https://www.vector.co/",
  "segmentId": 618,
  "segmentName": "ICP Visitors",
  "title": "Co-founder And Chief Executive Officer",
  "type": "contact.visited",
  "vvid": "1017f487-cce1-4476-b487-af3256275ab4"
}

3. Test Your Webhook Endpoint

There are three ways to test your endpoint. We recommend testing each before submitting your integration for review.

Test Manually

During development, you can send a request directly to your endpoint using a tool like:

  • Curl

  • HTTPie

  • Postman

Send a Test Event from Vector

You can test your endpoint directly from the Webhook integration:

  1. Navigate to Integrations from the bottom-left corner of Vector.

  2. Select Webhook.

  3. Click into the Endpoint you want to test.

  4. Send a test event and confirm your endpoint successfully receives and processes it.

Test with Real Segment Activity

You can also generate traffic to your webhook using a Vector Segment:

  1. Build a non-empty Segment.

  2. Add your webhook as an Action.

  3. Select Test Run.

  4. Confirm your endpoint successfully receives and processes the event.

4. Submit Your Integration

Once your integration is working, submit it to Vector so our team can review it for inclusion in the platform.

Send us:

  • Your product name and logo

  • A one-line description of what your integration does

  • An account in your product that our team can use for testing

We'll review the integration and work with you on the next steps for making it available in Vector.