Docs

WooCommerce Setup

Connect your WooCommerce store to sonarID for automatic VIP detection. No plugin required — WooCommerce's built-in webhook system sends order data directly to sonarID.

Setup time: under 5 minutes

01

Create a sonarID account

Sign up at sonarid.com. You can use email and password or sign in with Google.

After signing up, you will land on the sonarID dashboard. No Shopify store is required — sonarID works with any e-commerce platform via the API.

If you already have a sonarID account, skip to step 2.
02

Generate your API key

Go to Settings → Integrations in your sonarID dashboard.

In the API Access section, click Generate API Key.

Copy the key immediately — it will only be shown once. Store it somewhere safe (a password manager or environment variable).

This key authenticates your WooCommerce store with sonarID. Anyone with this key can send order data to your account, so treat it like a password.

You can revoke and regenerate your API key at any time from the same settings page.
03

Create a webhook in WooCommerce

In your WordPress admin, go to WooCommerce → Settings → Advanced → Webhooks.

Click Add Webhook and configure it with these settings:

// WooCommerce webhook settings
Name:sonarID VIP Detection
Status:Active
Topic:Order created
Delivery URL:https://sonarid.com/api/v1/woocommerce/webhook/YOUR_API_KEY
Secret:Your sonarID API key (same as in the URL)
API Version:WP REST API Integration v3 (default)
WooCommerce sends a test ping when you save the webhook. If sonarID receives it successfully, the webhook status will show as active. Replace YOUR_API_KEY in the Delivery URL with the key you generated in step 2 — it identifies your account, and using it again as the Secret lets sonarID verify the signature WooCommerce attaches to each webhook.
04

Place a test order

Place a test order in your WooCommerce store (or ask a friend to place one). Within a few seconds, the order will appear in your sonarID dashboard.

sonarID will automatically enrich the customer — checking their email against social profiles, public records, and identity databases. If the customer is a VIP (influencer, investor, celebrity, executive, or press), you will see their VIP score and classification in the dashboard.

If you have Slack connected, a VIP alert will fire immediately.

Enrichment typically completes within 2–5 seconds of order placement.

API request format

WooCommerce sends order data automatically via the webhook. If you want to send orders from a custom integration or another platform, use this format:

POST https://sonarid.com/api/v1/orders
Authorization: Bearer sk_live_your_api_key
Content-Type: application/json
{
"email": "customer@example.com",
"firstName": "Jane",
"lastName": "Smith",
"phone": "+15551234567",
"address": {
"city": "Atherton",
"state": "CA",
"zipcode": "94027",
"country": "US"
},
"order": {
"id": "wc_1042",
"number": "1042",
"total": "150.00",
"currency": "USD"
}
}

Required fields: email, firstName, lastName

Optional fields: phone, address, order

Other platforms

The sonarID API works with any platform that supports webhooks or custom integrations. The same POST /api/v1/orders endpoint accepts orders from BigCommerce, Squarespace, custom storefronts, or any system that can send an HTTP request.

If you need help connecting a platform not listed here, contact us and we will help you set it up.

← Getting started (Shopify)All docs