15 minutesIntermediateUpdated

Send conversions by webhook

To send conversions by webhook, POST each new order, signup or review to the widget's own webhook URL as JSON or form fields. Every field you send is stored with the conversion and can be used as a {variable} in the widget text.

The URL

Each data-driven widget (recent sales, sales counter, reviews) has its own URL in this format:

Webhook URL format
https://app.autosocialproof.com/pixel-webhook/YOUR_WIDGET_KEY

Steps

  1. Copy the widget webhook URL. Open the widget, go to its data settings and copy the webhook URL.
  2. Choose the fields to send. Decide what the popup should say, such as name, city and product.
  3. Send a test POST. Use curl, Postman or your automation tool with JSON or form fields.
  4. Check the Data tab. Confirm the test row and its field names.
  5. Use the fields as variables. Write the widget text with {name}, {city} and {product}.
  6. Connect your real source. Point your store, CRM or automation tool at the URL, then delete test rows.

Examples

JSON

JSON body
curl -X POST "https://app.autosocialproof.com/pixel-webhook/YOUR_WIDGET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Priya","city":"Austin","country_code":"US","product":"60-minute massage"}'

Form fields

Form-encoded
curl -X POST "https://app.autosocialproof.com/pixel-webhook/YOUR_WIDGET_KEY" \
  -d "name=Priya" -d "city=Austin" -d "product=60-minute massage"

A review

Review widget
curl -X POST "https://app.autosocialproof.com/pixel-webhook/YOUR_WIDGET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Rosa M.","description":"Arrived in two days.","stars":5}'

Only send events that really happened. Fabricated conversions break our acceptable use policy and consumer protection law.

For programmatic access to your account, see the API documentation.

Ready? Create a free account or log in to follow along.

Questions about this guide

What format does the webhook accept?

A POST with either a JSON body or form fields. Nested JSON is flattened; check the Data tab to see the resulting field names.

Which field names are special?

city, country and country_code are stored as the conversion location. For review widgets, title, description and stars (1 to 5) are required.

Is there authentication?

The widget key in the URL identifies the widget. Treat the URL like a password: do not publish it in client-side code.

How do I connect Zapier?

Add a "Webhooks by Zapier" POST action, paste the widget URL, choose JSON and map the fields.

How do I connect Make?

Use the HTTP "Make a request" module with method POST, the widget URL and a JSON body.

What happens to empty variables?

They are replaced with nothing, so write templates that still read well, or always send the field.

How quickly does a new conversion appear?

It is stored immediately and appears for the next visitors whose page loads the widget.

Can I delete test data?

Yes, from the widget's Data tab.

Stuck on a step? We reply within a business day.

Paste one line, turn on a widget built from real activity, and watch the analytics tell you what works.

  • Real people answer
  • Installation help is free
See pricingStart free

Popular

/ or Ctrl K opens search. Arrow keys move, Enter opens.

Display and accessibility

Theme
Colour palette
Text size
Accessibility statement

Checkout

Plan

  • Payment handled by Stripe. We never see your card number.
  • 30-day refund on your first payment.
  • Your account is created automatically after payment. Card statement: TheBigBot LLC.