Docs · Guide

Connect your CRM.

From Starter, every DemoPage lead can reach your CRM as a contact with a note of what they asked and saw: through a webhook and Zapier, Make, or n8n, the leads API, or an AI assistant. On Growth and Scale, your CRM can also send each new lead to DemoPage, which records a demo made for them before the first call.

Send every demo lead to your CRM

Every lead arrives as one crm record, the same in your webhook events, the leads API, and the MCP server: name, email, company, title, reason, their words, the pages they saw, their questions, and a note for the CRM's timeline. Match on email, so a buyer who comes back updates the same contact. To start with a webhook:

  1. 1In your portal, open Demo settings, then Guide and call to action, and open Send finished demos to a webhook (optional).
  2. 2Paste your Zapier, Make, or n8n webhook address under Webhook URL. It has to be a public https address, with no username or password in it.
  3. 3Press Save settings. A signing secret that starts with whsec_ then shows under the field.
  4. 4Send your own demo form once, then map crm in your tool: Create or Update Contact in HubSpot, a Lead in Salesforce, or a Person in Pipedrive, plus a note from crm.note.
  • lead.captured: someone sent the demo form, or asked for pricing or a follow-up. It carries crm.
  • demo.completed: a live demo ended, with what they saw and asked, and on Growth and Scale a recap link. It carries crm too.
  • demo.prepared: a demo made for a lead your CRM sent is ready, or couldn't be made.

Each event is a JSON POST. The x-demopage-event header names the event, and x-demopage-signature carries t, the Unix time, and v1, a hex HMAC-SHA256 of the time, a dot, and the body, keyed with your signing secret. If your endpoint can't be reached, times out, or answers 429 or 5xx, DemoPage tries twice more, 2 and 8 seconds later. Redirects aren't followed.

Read your leads with the API

  1. 1In your portal, open Demo settings, then Connect your CRM.
  2. 2Under API keys, name a key and press Make a key. Copy it right away: it starts with dp_key_ and isn't shown again.
  3. 3Read GET /api/v1/leads with the key as a bearer token. Use since for new leads only, email for one person, and next as before for older pages.
  • GET /api/v1/leads/{id} adds the lead's newest live demo in full and others from the same company in the last 30 days.
  • The API only reads. Each account can make 120 lead reads a minute, across its keys and AI tools, and can have 5 keys. A password reset revokes them all.
  • The full description is at https://app.demopage.io/api/v1/openapi.json.
curl -H "Authorization: Bearer dp_key_…" \
  "https://app.demopage.io/api/v1/leads?limit=50"

With an AI assistant

Connect DemoPage's MCP server at https://app.demopage.io/mcp and your CRM to the same AI assistant. Ask it to copy this week's DemoPage leads into your CRM. The prompt Copy my DemoPage leads into my CRM has it list the leads, say what it will create or update, and wait for your yes before it writes.

Turn on Demo before the first call

  1. 1Once you're live, open the Leads tab in your portal, find Demo before the first call, and press Turn on.
  2. 2Copy your intake key right away. It's shown only once.
  3. 3Open How to send a lead from HubSpot or Zapier and copy the Send leads to address. If you lose the key, press New key there; the old key stops working.
  4. 4To try it by hand first, fill in Prepare a demo for a lead now and press Prepare demo.

What to send

  • email: the lead's work email. Required.
  • goal: what they want to solve, such as the message from your demo form, in at least 12 characters. Required.
  • tools, company, and firstname, if you have them.
curl -X POST https://app.demopage.io/api/d/your-link/prepare \
  -H "Authorization: Bearer YOUR_INTAKE_KEY" \
  -H "content-type: application/json" \
  -d '{"email":"ada@example.com","goal":"Our reps log calls by hand.","tools":"HubSpot"}'

Send leads in from a HubSpot workflow

  1. 1In a contact workflow, add the action Send a webhook, with the method POST.
  2. 2Paste your Send leads to address as the webhook URL.
  3. 3For authentication, add your key as an API key named x-demopage-key, sent in the request header.
  4. 4HubSpot's contact fields are read as they are, so there's nothing to map.

Send leads in from Zapier

  1. 1Add the action Webhooks by Zapier, and choose POST.
  2. 2Paste your Send leads to address as the URL, and send the data as JSON.
  3. 3Map the lead's email and goal, and any of tools, company, and firstname.
  4. 4Add a header named Authorization with the value Bearer, a space, and your key.

What happens next

  • DemoPage records a walkthrough of your product made for that lead. Website visitors come first: it waits for a spare demo browser and uses at most half of the day's live demos.
  • Your team gets the demo and the lead's card by email and Slack, or a note when a demo couldn't be made.
  • With Email the lead their demo ticked, the lead gets it when every page loads as expected. Otherwise your team gets it to watch and send.
  • When the lead opens their demo, your team gets an alert.
  • Up to 25 demos in any 24 hours; past that, no demo is made for that lead. The same email within 7 days gets the same demo, unless the first one couldn't be made.
  • A prepared demo counts as one live demo once it shows at least two pages.

More guides