---
title: Open your first incident
description: Install the Pulseforge SDK, create an incident, and verify public status.
url: https://pr-1-801e0a17d1af.thally.app/quickstart
---

# Open your first incident

Install the Pulseforge SDK, create an incident, and verify public status.

This quickstart opens an incident through the typed SDK and confirms that it is
visible through the public status endpoint.

## Before you begin

- Node.js 20 or newer
- A running Pulseforge server
- A bearer token allowed to manage incidents

    ```bash
    npm install @pulseforge/events
    ```

    ```ts
    import { createPulseforgeClient } from "@pulseforge/events/sdk";

    const pulseforge = createPulseforgeClient({
      baseUrl: "https://status.example.com",
      token: process.env.PULSEFORGE_TOKEN,
    });
    ```

    ```ts
    const incident = await pulseforge.createIncident({
      title: "Delayed event delivery",
      severity: "degraded",
      serviceIds: ["events-api"],
    });
    ```

    Call `pulseforge.getStatus()`. The response reports `degraded` and includes
    the incident in `activeIncidents`.

## Continue the timeline

Use `addIncidentUpdate` as work progresses, then call `resolveIncident` when
the affected services are healthy.