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

# Tell your systems about new orders

> Have Customei notify your own tools the moment a personalized order comes in, and check every notification it sent.

Customei can tell your own systems as soon as something happens to a personalized order. Your fulfilment tool picks the order up on its own, and nobody has to retype anything.

In the app these are called **webhooks**. All that means is: you give Customei a web address, and Customei sends a message to it when something happens.

<Note>
  This is the one page in these docs that needs someone technical. You choose what gets sent and when; a developer sets up the address that receives it. If you don't have one, [support@customei.com](mailto:support@customei.com) can point them at what they need.
</Note>

## Set one up

Go to **Preferences**, open the **Integrations** tab, and find the **Webhooks** card at the bottom.

<Frame caption="The Webhooks card. Up to five addresses.">
  <img src="https://mintcdn.com/nexlify/LJ3k58_0NSNYDLkG/images/integrations/webhooks-card.png?fit=max&auto=format&n=LJ3k58_0NSNYDLkG&q=85&s=2654ed2c0fa2934cfdc25cba2c6cfbe4" alt="The Webhooks card in Customei preferences reading Register endpoints to receive notifications about order events, Max 5 subscriptions, with the Add webhook button highlighted." width="1316" height="328" data-path="images/integrations/webhooks-card.png" />
</Frame>

Click **Add webhook**.

<Frame caption="The address to notify, and which order events to send.">
  <img src="https://mintcdn.com/nexlify/LJ3k58_0NSNYDLkG/images/integrations/add-webhook.png?fit=max&auto=format&n=LJ3k58_0NSNYDLkG&q=85&s=b3dad00cac60b3d63b6430f7e73aef3c" alt="The Add webhook dialog with an Endpoint URL field, five event checkboxes for Order Created, Updated, Fulfilled, Cancelled and Paid, an optional description, and a checkbox acknowledging responsibility for order data." width="1304" height="1148" data-path="images/integrations/add-webhook.png" />
</Frame>

<Steps>
  <Step title="Paste the address">
    Your developer gives you this. It has to start with `https://`.
  </Step>

  <Step title="Tick the events you want">
    Five to choose from: when an order is **created**, **updated**, **paid**, **fulfilled**, or **cancelled**. Tick only what your tool actually reacts to.
  </Step>

  <Step title="Name it, so future-you knows what it is">
    The description is optional, but "Production fulfilment service" beats a bare address in six months' time.
  </Step>

  <Step title="Confirm you'll look after the data">
    Order notifications include order and customer details, so you tick to say you'll handle them properly.
  </Step>

  <Step title="Click Create">
    Customei sends a quick test to the address to make sure something is really listening. If nothing answers correctly, the address is rejected and nothing is saved.
  </Step>
</Steps>

<Warning>
  As soon as it's created, Customei shows you a **signing secret** once. Your developer needs it to check that a message really came from Customei. Copy it before you close the banner, because it is never shown in full again.
</Warning>

You can have up to **five** addresses. Once you have five, **Add webhook** stops working until you delete one.

## Check that it's working

Each row in the card shows the address, the events it's subscribed to, and whether it's **Active** or **Disabled**. Click the address to open it.

Inside you get:

* **Deliveries, last 30 days.** How many messages succeeded and how many failed, with a bar chart by day.
* **The delivery log.** Every attempt: which event it was, what set it off, whether it worked, the answer that came back, and when. Failed rows have a **Retry** button, so a message lost while your server was down doesn't have to be lost for good.
* **Disable** and **Enable**, for turning an address off without deleting it. Handy while your developer works on it.

<Warning>
  If an address fails 50 times in a row, Customei switches it off by itself and tells you on the Integrations tab. Nothing more is sent to it until someone fixes the address and turns it back on. Check the delivery log first, so you turn it back on for a reason rather than out of hope.
</Warning>

## Delete one

Use the bin icon on its row and confirm. It stops immediately and can't be undone. The address has to be set up again from scratch if you change your mind, including a new signing secret.

## Where to next

<CardGroup cols={2}>
  <Card title="Connecting other services" icon="plug" href="/integrations/overview">
    The rest of the Integrations tab.
  </Card>

  <Card title="Let an AI assistant help you" icon="wand-magic-sparkles" href="/preferences/ai-access">
    Another way to reach your account from outside.
  </Card>
</CardGroup>
