# Webhooks (https://docs.akollo.com/en/connections/webhooks)



Webhooks move events between Akollo and other systems as they happen. Inbound webhooks let another system notify Akollo. Outbound webhooks let Akollo notify another system.

<Mermaid
  title="Inbound and outbound webhooks"
  chart="`sequenceDiagram
participant S as Other system
participant A as Akollo
S->>A: Signed delivery to the receiver address
A->>A: Verify signature, replay and size
A-->>S: Accepted or rejected
A->>S: Signed event to the https endpoint
S-->>A: Delivery result, logged as an attempt`"
/>

## Inbound webhooks [#inbound-webhooks]

**Integrations → Inbound** creates an endpoint where a provider can send webhooks.

<Steps>
  <Step>
    ### Choose the purpose [#choose-the-purpose]

    Pick a **Purpose**: **Provider webhook**, **Automation trigger** or **Microsoft Graph lifecycle**.
  </Step>

  <Step>
    ### Choose the verifier [#choose-the-verifier]

    Pick a **Verifier**: **Standard Webhooks**, **Jira (HMAC)**, **Slack (v0 signature)**, **Microsoft Graph (clientState)** or **GitHub**. A method other than Standard Webhooks asks for the **Provider secret** the provider gave you.
  </Step>

  <Step>
    ### Link a connection (optional) [#link-a-connection-optional]

    Optionally choose an active connection the endpoint belongs to.
  </Step>

  <Step>
    ### Create the endpoint and store the details [#create-the-endpoint-and-store-the-details]

    Choose **Create endpoint**. The **Receiver URL**, and for Standard Webhooks the signing secret, are shown only once. Give the receiver address to the provider and store the secret safely.
  </Step>
</Steps>

The list shows when each endpoint last received a delivery. It counts rejected deliveries by reason (signature, replay or size) without showing the delivery itself. You can disable an endpoint and enable it again with a reason.

## Outbound webhooks [#outbound-webhooks]

**Integrations → Webhooks** sends this organisation's events to another system. An endpoint has:

* an https address;
* the event types to send;
* whether to send the full record or only a reference.

The signing secret is shown once. The list shows each endpoint's address, events, state and delivery success over the last 24 hours.

<Screenshot src="/screens/en/webhooks.webp" alt="Outbound webhooks list with two endpoints, their event types, an Enabled and a Disabled badge, and a reason field next to Disable and Re-enable" caption="Outbound webhooks: each endpoint with its events and state." />

An endpoint's page shows its message log with filters and the delivery attempts of each message. From there you can:

* replay one or several messages;
* recover everything sent since a chosen time, up to 30 days back;
* send a test event;
* rotate the signing secret; the previous secret keeps working for 24 hours.

A failing endpoint shows when it started failing and when it will disable itself. An endpoint can be disabled with a reason and re-enabled; it cannot be deleted.

<Callout type="info" title="Note">
  In this release outbound delivery is not switched on yet. The pages do not offer creating an endpoint, sending a test event, replaying messages or recovering since a time.
</Callout>

## FAQ [#faq]

<Accordions type="single">
  <Accordion title="I lost the signing secret. Can I see it again?">
    No. Signing secrets are shown once. For an outbound endpoint you can rotate the secret; the previous one keeps working for 24 hours.
  </Accordion>

  <Accordion title="Can I see a rejected inbound delivery?">
    No. The list counts rejected deliveries by reason (signature, replay or size) but does not show the delivery itself.
  </Accordion>

  <Accordion title="Can I delete an outbound endpoint?">
    No. You can disable it with a reason and re-enable it later.
  </Accordion>

  <Accordion title="How far back can I recover outbound messages?">
    Up to 30 days back from the time you choose. In this release outbound delivery is not switched on yet.
  </Accordion>
</Accordions>

## Related pages [#related-pages]

* [Connected systems](/en/connections)
* [API and keys](/en/connections/api)
* [Automation](/en/product-guide/automation)