Aanmeld Webhook

POST/api/webhooks/signup/:contestId

Webhook Secret

Ontvang aanmeldevenementen van je applicatie of externe diensten om automatisch wedstrijdinzendingen aan te maken.

Endpoint

text

POST https://blitzrocket.com/api/webhooks/signup/:contestId

Padparameters

contestIdstring required

De unieke wedstrijdidentificatie

Verzoek Body

emailstring required

E-mailadres van de nieuwe aanmelding

namestring

Naam van de nieuwe aanmelding (optioneel)

phonestring

Telefoonnummer (optioneel)

referralCodestring

Verwijzingscode als de aanmelding via een verwijzing kwam (optioneel)

Verzoek

bash

curl -X POST https://blitzrocket.com/api/webhooks/signup/clx1abc123 \
  -H "Content-Type: application/json" \
  -d '{
    "email": "newuser@example.com",
    "name": "Nieuwe Gebruiker"
  }'

javascript

const contestId = "clx1abc123";
const response = await fetch(
  `https://blitzrocket.com/api/webhooks/signup/${contestId}`,
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      email: "newuser@example.com",
      name: "Nieuwe Gebruiker",
    }),
  }
);

const data = await response.json();
console.log(data);

python

import requests

contest_id = "clx1abc123"
response = requests.post(
    f"https://blitzrocket.com/api/webhooks/signup/{contest_id}",
    json={
        "email": "newuser@example.com",
        "name": "Nieuwe Gebruiker"
    }
)

data = response.json()
print(data)

Respons

json

{
  "success": true,
  "data": {
    "entryId": "entry_new789",
    "email": "newuser@example.com",
    "alreadyExists": false,
    "isReferred": false,
    "pointsAwarded": {
      "advocate": 0,
      "friend": 0
    }
  }
}

Installatiehandleiding

Navigeer naar de Design pagina van je wedstrijd in het Blitz Rocket dashboard
Schakel Externe Tracking in bij de wedstrijdinstellingen
Kopieer je webhook-URL: https://blitzrocket.com/api/webhooks/signup/{your-contest-id}
Stel je externe platform zo in dat het POST-verzoeken naar deze URL stuurt bij aanmeldevenementen

Integratievoorbeelden

Shopify Klantcreatie

Configureer een Shopify webhook die afgaat bij customers/create:

javascript

// Shopify stuurt deze payload automatisch:
{
  "email": "customer@example.com",
  "first_name": "Jane",
  "last_name": "Doe"
}

Aangepast Aanmeldformulier

javascript

document.querySelector("#signup-form").addEventListener("submit", async (e) => {
  e.preventDefault();

  const form = new FormData(e.target);
  const email = form.get("email");
  const name = form.get("name");

  // Registreer eerst in je systeem
  await registerUser({ email, name });

  // Maak daarna wedstrijdinzending aan via webhook
  await fetch(
    `https://blitzrocket.com/api/webhooks/signup/${CONTEST_ID}`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ email, name }),
    }
  );
});