Dashboard

Contacts

Auth Required

Erase Contact

POSThttps://api.inboxjot.com/v1/contacts/erase

Erases a person for a privacy request. Needs a Full key. A key limited to one domain answers 403. Send an optional Idempotency-Key header to retry safely. See Idempotency.

Inboxjot deletes the contact and their emails, events and logs in this workspace, within a few minutes. It erases the address even when no contact exists. The address stays on the suppression list, so it is not emailed again.

POST/v1/contacts/erase
curl -X POST https://api.inboxjot.com/v1/contacts/erase \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "riti@example.com"
  }'
{
  "status": "queued"
}

Accepted. The contact, if any, is deleted and the erase is queued.

Body Parameters

emailstringrequired

The address to erase, up to 320 characters. It does not need to belong to a contact.

Response

statusstring

queued. The erase finishes within a few minutes.

Responses

POST/v1/contacts/erase
curl -X POST https://api.inboxjot.com/v1/contacts/erase \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "riti@example.com"
  }'
{
  "status": "queued"
}

Accepted. The contact, if any, is deleted and the erase is queued.