Errors

{
  "error": "Human-readable description of the error"
}

{
  "error": "Validation failed",
  "details": [
    { "path": "events[0].eventType", "message": "Invalid enum value" }
  ]
}

{
  "error": "Validation failed",
  "details": [
    { "path": "events", "message": "Array must contain at least 1 element(s)" }
  ]
}

{ "error": "Unauthorized" }

{ "error": "Forbidden" }

{ "error": "Not found" }

{ "error": "A flow with this name already exists" }

{
  "error": "Rate limit exceeded",
  "retryAfter": 23
}

{ "error": "Internal server error" }

async function callZenstepAPI(url, options) {
  const response = await fetch(url, options);

  if (!response.ok) {
    const body = await response
      .json()
      .catch(() => ({ error: "Unknown error" }));

    switch (response.status) {
      case 400:
        console.error("[Zenstep] Validation error:", body.details);
        break;
      case 401:
        console.error(
          "[Zenstep] Authentication failed — check your snippet key",
        );
        break;
      case 429:
        console.warn(
          `[Zenstep] Rate limited — retry after ${body.retryAfter}s`,
        );
        break;
      case 500:
        console.error("[Zenstep] Server error — check status.getzenstep.com");
        break;
      default:
        console.error("[Zenstep] API error:", body.error);
    }

    throw new Error(body.error);
  }

  return response.json();
}