Mailactor
API reference

List webhooks

Required scope: webhook:manage.

GET/v1/webhooks

Authorization

tenantApiKey
x-api-key<token>

A scoped tenant key returned once by an operator. Never place it in URLs, logs, prompts, or client-side application code.

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
cursor?string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

# Set the API key and replace resource IDs with your saved IDs.curl --fail-with-body --silent --show-error -X GET \  "https://api.mailactor.com/v1/webhooks" \  -H "x-api-key: $MAILACTOR_API_KEY"

Response examples

Illustrative values; save the IDs and limits returned by your own requests.

HTTP 200

{
  "endpoints": [
    {
      "id": "whk_0123456789abcdef01234567",
      "url": "https://your-app.example.com/webhooks/mailactor",
      "events": [
        "message.received"
      ],
      "status": "active",
      "createdAt": "2026-09-08T12:00:00.000Z",
      "updatedAt": "2026-09-08T12:00:00.000Z"
    }
  ],
  "nextCursor": null
}