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

# Perl SDK webhook client

> Create, list, get, update, and delete Paubox webhook endpoints with the Perl SDK to receive delivery, open, failure, and inbound mail events.

Webhook functions are exported from `Paubox_Email_SDK`.

```perl theme={null}
use Paubox_Email_SDK qw(
    listWebhookEndpoints createWebhookEndpoint
    getWebhookEndpoint updateWebhookEndpoint
    deleteWebhookEndpoint
);
```

## List webhook endpoints

```perl theme={null}
my $endpoints = listWebhookEndpoints();
```

## Create a webhook endpoint

```perl theme={null}
my $endpoint = createWebhookEndpoint({
    target_url => 'https://example.com/webhooks/paubox',
    events     => ['inbound_mail_received', 'api_mail_log_delivered'],
    signing_key => 'whsec_abc123',
    active     => 1,
});
```

## Get a webhook endpoint

```perl theme={null}
my $endpoint = getWebhookEndpoint(42);
```

## Update a webhook endpoint

```perl theme={null}
my $endpoint = updateWebhookEndpoint(42, {
    active => 0,
});
```

## Delete a webhook endpoint

```perl theme={null}
my $endpoint = deleteWebhookEndpoint(42);
```


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