Delete a contact

DELETE/v1/contacts/{id}

Secret key — sk_… or sk_test_… · Base URL https://api.volanea.com

Deletes the contact record. Two things deliberately survive it.

The send log. Rows in GET /v1/emails keep the address and their now-dangling contactId, because discarding delivery history along with the contact would erase the bounce and complaint record you are required to be able to produce.

Suppressions. The do-not-send list is keyed by address, not by contact, so deleting a contact does not make a suppressed address mailable again — and re-creating the contact does not either. Use DELETE /v1/suppressions/{id} if that is what you meant.

Path parameters

idstringrequired
Contact id.

Response

Deleted.

successbooleanrequired

Errors

Every failure returns the standard envelope — branch on `code`, never on the wording of `error`.

401Missing or invalid API key.
404Not found.
422Request validation failed (code `validation_error`, 422).

Request

curl https://api.volanea.com/v1/contacts/id_123 \
  -X DELETE \
  -H "Authorization: Bearer sk_..."

Response

200 · application/json

{
  "success": true,
  "data": {
    "success": true
  }
}

92 endpoints · OpenAPI document