VVikk AI Ad CenterDeveloper Guide

Getting started

Quickstart

From an Ad Center account to a lead landing in your system.

Before you begin

  • An active Vikk AI Ad Center account with at least one campaign.
  • Admin access to the CRM or endpoint that will receive leads.

1. Choose your delivery method

Use a native integration when your CRM is supported — Vikk handles field mapping, authentication, and retries. Use webhooks when you need full control or your CRM isn't supported yet.

  • Native: Available for Clio Grow and Lawmatics through OAuth.
  • Webhook: Best for custom intake platforms or any CRM not yet supported natively.

2. Connect the destination

Native CRM (Clio Grow or Lawmatics)

  1. Log in to the Vikk AI Ad Center.
  2. Go to Integrations.
  3. Choose Clio or Lawmatics and authorize Vikk via OAuth.
  4. Once authorized, Vikk Ad Center will forward leads to your connected CRM.

Vikk maps the lead to standard CRM fields automatically — no code or manual import is needed.

Webhook

  1. Expose a public HTTPS endpoint on your server (for example https://api.yourfirm.com/vikk-leads). Non-HTTPS endpoints will be rejected.
  2. In Vikk AI Ad Center, go to Webhook Configurations and click Create Webhook. Provide your endpoint URL and a friendly name.
  3. Copy the generated signing_secret and store it securely in your server environment. It is encrypted on Vikk's side and cannot be retrieved later.
  4. Set the webhook to enabled.

3. Send a test lead

Native CRM

Generate or wait for a qualified lead in your Vikk AI Ad Center campaign. Open your connected CRM and confirm the corresponding record was created. You can also check the Ad Center activity log for delivery status.

Webhook

Use the Vikk AI Ad Center webhook configuration panel to send a test event. Your endpoint should:

  1. Capture the raw request body and verify the X-Vikk-Signature using HMAC-SHA256 and your signing_secret.
  2. Validate the X-Vikk-Timestamp is within a few minutes of the current time.
  3. Store the X-Vikk-Idempotency-Key and skip duplicates if the same key is seen again.
  4. Return a 2xx response to acknowledge receipt.

Security requirement

Webhooks carry live consumer contact details. Always verify the signature and timestamp before processing the payload. See the Webhooks integration guide for the full verification example.

4. Verify delivery

Open the Ad Center activity log to confirm the lead was accepted by your destination. Failed deliveries are retried automatically for both native integrations and webhooks.

PreviousIntroductionNextAuthentication