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

Remove a forward destination

DELETE/v1/inbound/forward-destinations/{id}

Remove a forward destination; routes forwarding there only store from then on.

Requires a full-access live key; test keys get 403 test_key_restricted.

Path parameters

idstring
Forward destination id.

Errors

restricted_api_keyHTTP 403
test_key_restrictedHTTP 403
test-mode keys can send test email and read, not change the account: use a live key
not_foundHTTP 404
forward destination not found
DELETE/v1/inbound/forward-destinations/{id}
curl -X DELETE 'https://zapsmtp.xyz/v1/inbound/forward-destinations/019a1c55-0d6e-7f21-8b3a-5e9d4c7b2a10' \
  -H "Authorization: Bearer $ZAP_API_KEY"
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "forward_destination",
  "id": "0199f0b2-0000-7000-8000-00000000f001",
  "deleted": true
}