Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Click actions

List actions

GET/v1/actions

List every action of the account: the ones you declared, the ones links named in the last 30 days, and the ones templates and webhook filters use. Sorted by name.

Requires a full-access key.

declared is false for an action that links use but nobody described; created_at and updated_at are then null.

clicks_7d, clicks_30d and unique_clickers_30d (distinct email and recipient pairs) count the last 7 and 30 days; last_click_at is null without a click in 30 days. templates counts the templates whose draft or published HTML names the action; webhooks lists the ids of the endpoints filtered on it.

Errors

restricted_api_keyHTTP 403
GET/v1/actions
curl 'https://zapsmtp.xyz/v1/actions' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "action",
      "name": "confirm_order",
      "description": "Customer confirms the order from the receipt",
      "declared": true,
      "created_at": "2026-10-24T09:12:00Z",
      "updated_at": "2026-10-24T09:12:00Z",
      "clicks_7d": 42,
      "clicks_30d": 180,
      "unique_clickers_30d": 171,
      "last_click_at": "2026-10-27T08:41:05Z",
      "templates": 1,
      "webhooks": [
        "019a1c55-0d6e-7f21-8b3a-5e9d4c7b2a10"
      ]
    },
    {
      "object": "action",
      "name": "track_parcel",
      "description": "",
      "declared": false,
      "created_at": null,
      "updated_at": null,
      "clicks_7d": 12,
      "clicks_30d": 64,
      "unique_clickers_30d": 60,
      "last_click_at": "2026-10-26T19:02:44Z",
      "templates": 2,
      "webhooks": []
    }
  ]
}