> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Skicka försändelse-, order- och spårningshändelser från Zippendo till ditt eget system: namn, endpoint-URL, händelser, leveranslogg, testmeddelande, redigering, radering och signaturkontroller.

**Webhooks** låter ditt eget system veta i samma stund som något händer i Zippendo: en försändelse skapas eller skickas, en order ändras eller ett paket får en ny spårningshändelse. Zippendo skickar ett meddelande till en adress (URL) på din server. Du ställer in dem under **Webhooks** i Inställningar. Mottagarsidan byggs oftast av en utvecklare.

Det här är inte de andra sorters webhooks som du kan möta i Zippendo:

| Sort | Var | Riktning |
| - | - | - |
| **Webhooks** (den här sidan) | Inställningar → **Webhooks** | Zippendo → din server |
| Spårningswebhooks från transportörer | På en transportör | Transportör → Zippendo. Se [Spårningswebhooks från transportörer](/docs/sv/how-to/tracking-webhooks). |
| Order-webhooks från Shopify | På en Shopify-orderkanal | Shopify → Zippendo. Zippendo ställer in dem. Se [Shopify-inställningar](/docs/sv/how-to/shopify-settings). |
| Order-webhooks från WooCommerce | På en WooCommerce-orderkanal | WooCommerce → Zippendo. Se [Anslut WooCommerce](/docs/sv/how-to/connect-woocommerce). |
| Ordrar via egen kanal | På en egen orderkanal | Ditt system → Zippendo. Se [API för egen kanal](/docs/sv/how-to/custom-channel-api). |

Om du vill skicka händelser till Slack, Klaviyo och liknande appar utan att bygga något använder du i stället [Anslut Slack, Klaviyo och andra appar](/docs/sv/how-to/connect-an-integration).

Rundtur i Inställningar: [Inställningar, team och varumärken](/docs/sv/tutorials/settings-team-brands). Vad varje meddelande innehåller: [Snabbstart för webhooks](/docs/sv/quickstarts/webhooks). Meddelanden som inte kommer fram: [Leveransfel för webhooks](/docs/sv/knowledge-base/webhook-delivery-failures).

<Info>
  Webhooks ingår i alla planer: Free upp till 5 webhooks, Standard upp till 10, Growth upp till 25, Pro upp till 100, Enterprise obegränsat.
</Info>

## Var du hittar det

Öppna organisationsmenyn längst ned i sidofältet, klicka på **Hantera** och sedan på fliken **Webhooks**. Knappen för att skapa en är **Lägg till webhook** uppe till höger.

<Frame caption="Listan Webhooks: namn, URL, händelser, status och åtgärder">
  <img src="https://mintcdn.com/zippendo/7Xa6Qmdyx4UK2Juz/images/sv/how-to/webhooks/01-webhooks-list-light.png?fit=max&auto=format&n=7Xa6Qmdyx4UK2Juz&q=85&s=91d09a0419db375c2dfa24c540ba2fdb" alt="Fliken Webhooks i Inställningar med en webhook i listan och Lägg till webhook i rubrikfältet" className="block dark:hidden" width="2880" height="1800" data-path="images/sv/how-to/webhooks/01-webhooks-list-light.png" />

  <img src="https://mintcdn.com/zippendo/7Xa6Qmdyx4UK2Juz/images/sv/how-to/webhooks/01-webhooks-list-dark.png?fit=max&auto=format&n=7Xa6Qmdyx4UK2Juz&q=85&s=96b9355772a48977620f395e2d8dafb7" alt="Fliken Webhooks i Inställningar med en webhook i listan och Lägg till webhook i rubrikfältet" className="hidden dark:block" width="2880" height="1800" data-path="images/sv/how-to/webhooks/01-webhooks-list-dark.png" />
</Frame>

## Listan Webhooks

| Kolumn | Vad den visar |
| - | - |
| **Namn** | Namnet du angav. |
| **Varumärke** | Webhookens varumärke, eller tomt om den gäller hela organisationen. Visas bara om din organisation har varumärken. |
| **URL** | Adressen som Zippendo skickar till. |
| **Händelser** | De två första händelser den skickar, till exempel **Försändelse skapad**. Resten är hopfällda. |
| **Status** | **Aktiv** eller **Inaktiv**. |
| **Skapat** | När den skapades. |

Varje rad har **Leveranslogg**, **Skicka test**, **Redigera** och **Radera**. Ett klick på raden öppnar **Redigera webhook**.

Om du vill hitta en webhook klickar du på **Filter** ovanför listan. Du kan söka på namn, välja **Aktiv** (**Ja** eller **Nej**) och, om du har varumärken, ett **Varumärke**. Klicka på **Lägg till filter** för att tillämpa. Mer om listor: [Sök och filter](/docs/sv/how-to/search-and-filters).

När det inte finns några webhooks än visar listan **Inga webhooks** och en knapp **Skapa din första webhook**.

## Skapa en webhook

<Steps>
  <Step title="Öppna fönstret">
    Klicka på **Lägg till webhook**, eller **Skapa din första webhook** när listan är tom. Fönstret **Skapa webhook** öppnas.
  </Step>

  <Step title="Namn och adress">
    Fyll i **Namn \*** och **Endpoint-URL \***. Använd en adress som börjar med `https://`.
  </Step>

  <Step title="Välj händelser">
    Kryssa i de händelser du vill ha, eller klicka på **Markera alla**. Kryssa i **Spårning uppdaterad** om ditt system behöver varje spårningsskanning.
  </Step>

  <Step title="Skapa den">
    Klicka på **Skapa webhook**. Du ser **Webhooken har skapats**.
  </Step>
</Steps>

<Frame caption="Skapa webhook: Namn, Endpoint-URL och händelserna">
  <img src="https://mintcdn.com/zippendo/7Xa6Qmdyx4UK2Juz/images/sv/how-to/webhooks/02-create-webhook-light.png?fit=max&auto=format&n=7Xa6Qmdyx4UK2Juz&q=85&s=05a10568b26b82407161bff400461458" alt="Fönstret Skapa webhook med Namn, Endpoint-URL, Markera alla och kryssrutorna för försändelsehändelser" className="block dark:hidden" width="2880" height="2800" data-path="images/sv/how-to/webhooks/02-create-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/7Xa6Qmdyx4UK2Juz/images/sv/how-to/webhooks/02-create-webhook-dark.png?fit=max&auto=format&n=7Xa6Qmdyx4UK2Juz&q=85&s=89e168028013d55c57cc159731f31101" alt="Fönstret Skapa webhook med Namn, Endpoint-URL, Markera alla och kryssrutorna för försändelsehändelser" className="hidden dark:block" width="2880" height="2800" data-path="images/sv/how-to/webhooks/02-create-webhook-dark.png" />
</Frame>

| Fält | Obligatoriskt | Vad du anger |
| - | - | - |
| **Namn \*** | Ja | Ett namn som du känner igen, till exempel ”Ordernotiser”. Upp till 100 tecken. |
| **Endpoint-URL \*** | Ja | Den fullständiga adressen på din server, till exempel `https://example.com/webhooks`. |
| **Varumärke** | Nej | Visas bara om din organisation har varumärken. Välj ett varumärke och **Den här webhooken tar bara emot det här varumärkets händelser.** Standardvalet, **Inget varumärke (hela organisationen)**, tar emot händelserna för alla varumärken. |
| **Händelser \*** | Ja, minst en | De händelser som ska skickas. Se listan nedan. |

**Skapa webhook** är grå tills du har fyllt i namnet, adressen och minst en händelse. Om skapandet misslyckas med **Du har nått gränsen i din plan. Uppgradera planen eller ta bort något du inte längre använder.** raderar du en webhook som du inte längre använder eller uppgraderar din plan.

### Händelserna

Det finns nio händelser, i tre grupper. Det tekniska namnet i andra kolumnen är det som ditt system tar emot.

<Frame caption="Markera alla kryssar i alla händelser, inklusive Spårning uppdaterad">
  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/03-events-tracking-light.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=f500f29096e9443a72e14be2d4269b86" alt="Fönstret Skapa webhook med alla nio händelser ikryssade, inklusive Spårning uppdaterad" className="block dark:hidden" width="2880" height="2800" data-path="images/sv/how-to/webhooks/03-events-tracking-light.png" />

  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/03-events-tracking-dark.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=82ff5e83866484ddfeb0972eee59f705" alt="Fönstret Skapa webhook med alla nio händelser ikryssade, inklusive Spårning uppdaterad" className="hidden dark:block" width="2880" height="2800" data-path="images/sv/how-to/webhooks/03-events-tracking-dark.png" />
</Frame>

| Händelse | Namn som ditt system tar emot | Skickas när |
| - | - | - |
| **Försändelse skapad** | `shipment.created` | En försändelse skapas. |
| **Försändelse uppdaterad** | `shipment.updated` | En försändelse ändras. |
| **Försändelse skickad** | `shipment.dispatched` | En försändelse skickas och har sin fraktetikett. |
| **Försändelse annullerad** | `shipment.cancelled` | En försändelse raderas. |
| **Fel på försändelse** | `shipment.error` | Det misslyckas att skicka en försändelse till transportören. |
| **Order skapad** | `order.created` | En order skapas via API:et. |
| **Order uppdaterad** | `order.updated` | En order ändras i Zippendo eller via API:et. |
| **Order annullerad** | `order.cancelled` | En order raderas i Zippendo eller via API:et. |
| **Spårning uppdaterad** | `tracking.updated` | Ett paket får en ny spårningshändelse. |

Ordrar som kommer in från en ansluten webbutik, och de ändringar webbutiken skickar senare, skickar inga orderhändelser. Ditt system får ändå veta om dem via försändelsehändelserna: Zippendo skapar en försändelse för varje order som importeras.

**Skicka test** skickar ett testmeddelande som heter `webhook.test`. Du kan inte kryssa i det som en händelse.

## Redigera eller pausa en webhook

Klicka på raden, eller **Redigera**, för att öppna **Redigera webhook**. Den har samma fält som **Skapa webhook**, plus **Aktiv**. Klicka på **Spara ändringar** när du är klar.

<Frame caption="Redigera webhook: samma fält, plus Aktiv">
  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/04-edit-webhook-light.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=6ace85fc15b9ba80d9b4657d97912c66" alt="Fönstret Redigera webhook med Namn, Endpoint-URL, en kryssruta Aktiv och händelserna" className="block dark:hidden" width="2880" height="1800" data-path="images/sv/how-to/webhooks/04-edit-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/04-edit-webhook-dark.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=6964aeb1dedf05942b4366d56e911838" alt="Fönstret Redigera webhook med Namn, Endpoint-URL, en kryssruta Aktiv och händelserna" className="hidden dark:block" width="2880" height="1800" data-path="images/sv/how-to/webhooks/04-edit-webhook-dark.png" />
</Frame>

Ta bort kryssen vid **Aktiv** för att sluta skicka utan att radera webhooken eller dess **Leveranslogg**. Kolumnen **Status** visar då **Inaktiv**. Kryssa i den igen för att börja skicka.

## Leveranslogg

**Leveranslogg** på en rad visar de senaste försöken att leverera till den adressen.

<Frame caption="Leveranslogg: händelse, status, varaktighet, försök, fel och tid">
  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/05-delivery-log-light.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=43f5260d74d730e207c95a51143e72c9" alt="Leveransloggen med händelsenamn, svarsstatus, varaktighet, försök och tid" className="block dark:hidden" width="2880" height="1800" data-path="images/sv/how-to/webhooks/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/05-delivery-log-dark.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=5736d0c8a5906345e53f84d0d6601c5d" alt="Leveransloggen med händelsenamn, svarsstatus, varaktighet, försök och tid" className="hidden dark:block" width="2880" height="1800" data-path="images/sv/how-to/webhooks/05-delivery-log-dark.png" />
</Frame>

| Kolumn | Vad den visar |
| - | - |
| **Händelse** | Den händelse som skickades, till exempel `shipment.created` eller `webhook.test`. |
| **Status** | Den statuskod som din server svarade med, grön för lyckad och röd för misslyckad, eller **Saknas** om det inte kom något svar. |
| **Varaktighet** | Hur lång tid din server tog på sig att svara. |
| **Försök** | Vilket försök det var. |
| **Fel** | Vad som gick fel, om något. |
| **Tid** | När försöket gjordes. |

Zippendo väntar upp till 10 sekunder på att din server ska svara. Om den inte svarar, eller svarar med ett fel, försöker Zippendo igen, upp till 5 gånger totalt, och väntar lite längre varje gång. Varje försök är en rad i loggen.

## Skicka ett testmeddelande

Klicka på **Skicka test** på en rad. Du ser **Testhändelsen har skickats**. Testmeddelandet ser ut så här:

```json theme={null}
{
  "event": "webhook.test",
  "timestamp": "2026-06-22T09:30:00.000Z",
  "data": {
    "webhookId": "cm9x2k4lq0001",
    "message": "This is a test event from Zippendo"
  }
}
```

Öppna **Leveranslogg** för att se om din server tog emot det.

## Radera en webhook

Klicka på **Radera** på en rad. **Radera webhook** ber dig skriva webhookens namn med versaler och sedan klicka på **Radera**. Webhooken och dess **Leveranslogg** tas bort och du ser **Webhooken har raderats**.

<Frame caption="Radera webhook: skriv namnet med versaler för att bekräfta">
  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/06-delete-webhook-light.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=c3ee442262917a720833c6052c688473" alt="Fönstret Radera webhook med ett fält för att skriva namnet och bekräfta" className="block dark:hidden" width="2880" height="1800" data-path="images/sv/how-to/webhooks/06-delete-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/RYtv0mVIf2d7fbe6/images/sv/how-to/webhooks/06-delete-webhook-dark.png?fit=max&auto=format&n=RYtv0mVIf2d7fbe6&q=85&s=3f1686c2f5ff11a119a2cbbc04e968f6" alt="Fönstret Radera webhook med ett fält för att skriva namnet och bekräfta" className="hidden dark:block" width="2880" height="1800" data-path="images/sv/how-to/webhooks/06-delete-webhook-dark.png" />
</Frame>

## För utvecklare: meddelandeformat och signatur

Varje meddelande är en `POST` med en JSON-kropp `{ "event", "timestamp", "brandId", "data" }` och de här rubrikerna:

| Rubrik | Värde |
| - | - |
| `Content-Type` | `application/json` |
| `X-Webhook-Signature` | HMAC-SHA256 av den råa kroppen, hex, nyckel är webhookens hemlighet |
| `X-Webhook-Event` | Händelsens namn |
| `X-Webhook-Id` | Ett ID per leverans. Varje nytt försök för samma leverans skickar samma ID, så du kan använda det för att hoppa över dubbletter. |

Zippendo skapar hemligheten när du skapar webhooken. Appen visar den inte: läs den med anropet Get webhook i [API-referensen](/docs/api-reference/overview) (listanropet utelämnar den). Kontrollera signaturen innan du läser kroppen. Ett genomarbetat exempel finns i [Snabbstart för webhooks](/docs/sv/quickstarts/webhooks). Ordrar som skickas till en egen orderkanal signeras på samma sätt, med rubriken `X-Zippendo-Signature`: [API för egen kanal](/docs/sv/how-to/custom-channel-api).

<Tip>
  Svara snabbt med en 2xx-status och gör arbetet efteråt. Använd `https://`-adresser. Webhooks som inte är **Aktiv** tar inte emot något.
</Tip>

## Relaterat

* [Skapa en API-token](/docs/sv/how-to/create-an-api-token): ditt system frågar Zippendo, i stället för att Zippendo berättar för ditt system.
* [Spårningswebhooks från transportörer](/docs/sv/how-to/tracking-webhooks): transportörer som skickar spårning till Zippendo.
* [Anslut Slack, Klaviyo och andra appar](/docs/sv/how-to/connect-an-integration): ingen egen server behövs.
* [Shopify-inställningar](/docs/sv/how-to/shopify-settings) / [Anslut WooCommerce](/docs/sv/how-to/connect-woocommerce): de webbutikswebhooks som Zippendo ställer in åt dig.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.