Skip to main content
GET
/
webhooks
List Webhooks
curl --request GET \
  --url https://app.lettr.com/api/webhooks \
  --header 'Authorization: Bearer <token>'
{
  "message": "Webhooks retrieved successfully.",
  "data": {
    "webhooks": [
      {
        "id": "webhook-abc123",
        "name": "Order Notifications",
        "url": "https://example.com/webhook",
        "enabled": true,
        "event_types": [
          "message.delivery",
          "message.bounce"
        ],
        "auth_type": "basic",
        "has_auth_credentials": true,
        "last_successful_at": "2024-01-15T10:30:00+00:00",
        "last_failure_at": null,
        "last_status": "success"
      },
      {
        "id": "webhook-def456",
        "name": "Support Notifications",
        "url": "https://example.com/support-webhook",
        "enabled": false,
        "event_types": null,
        "auth_type": "none",
        "has_auth_credentials": false,
        "last_successful_at": null,
        "last_failure_at": "2024-01-14T08:00:00+00:00",
        "last_status": "failure"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

API key for authentication

Response

List of webhooks retrieved successfully

Response containing a list of webhooks

​
message
string
required

Human-readable response message

Example:

"Webhooks retrieved successfully."

​
data
object
required