Anmelde-Webhook

POST/api/webhooks/signup/:contestId

Webhook Secret

Empfangen Sie Anmeldeereignisse von Ihrer Anwendung oder Drittanbieterdiensten, um automatisch Wettbewerbseinträge zu erstellen.

Endpunkt

text

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

Pfadparameter

contestIdstring required

Die eindeutige Wettbewerbs-ID

Anfragetext

emailstring required

E-Mail-Adresse der neuen Anmeldung

namestring

Name der neuen Anmeldung (optional)

phonestring

Telefonnummer (optional)

referralCodestring

Empfehlungscode, falls die Anmeldung über eine Empfehlung erfolgte (optional)

Anfrage

bash

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

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: "New User",
    }),
  }
);

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": "New User"
    }
)

data = response.json()
print(data)

Antwort

json

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

Einrichtungshinweis

Navigieren Sie zur Design-Seite Ihres Wettbewerbs im Blitz Rocket Dashboard
Aktivieren Sie Externe Verfolgung in den Wettbewerbseinstellungen
Kopieren Sie Ihre Webhook-URL: https://blitzrocket.com/api/webhooks/signup/{your-contest-id}
Konfigurieren Sie Ihre externe Plattform so, dass sie bei Anmeldeereignissen POST-Anfragen an diese URL sendet

Integrationsbeispiele

Shopify Kundenanlage

Konfigurieren Sie einen Shopify-Webhook, der bei customers/create ausgelöst wird:

javascript

// Shopify sendet diese Nutzlast automatisch:
{
  "email": "customer@example.com",
  "first_name": "Jane",
  "last_name": "Doe"
}

Eigenes Anmeldeformular

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");

  // Zuerst im eigenen System registrieren
  await registerUser({ email, name });

  // Dann Wettbewerbseintrag über Webhook erstellen
  await fetch(
    `https://blitzrocket.com/api/webhooks/signup/${CONTEST_ID}`,
    {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ email, name }),
    }
  );
});