Skip to main content
DELETE
/
api
/
email
/
accounts
/
{id}
Delete an email sender account
curl --request DELETE \
  --url https://app.puffle.ai/api/email/accounts/{id} \
  --header 'Authorization: Bearer <token>'
{ "success": true }

​
Overview

Disables Instantly warmup, deletes the Instantly account, deletes the AgentMail inbox, and removes the DB row for a single email sender account. External cleanup steps are best-effort; failures are logged but do not block the DB delete.
This operation shares the URL path /api/email/accounts/{id} with the update verb. See Update an email sender account to modify the signature without tearing the account down.

​
AI agent notes

Deletion is irreversible. AgentMail blocks creating a new inbox with the same <username>@<domain> after deletion. If an agent is deleting an inbox on behalf of a user, confirm with the human first — the only recovery path is picking a different local part.External cleanup is best-effort. Instantly warmup/disable + Instantly account-delete + AgentMail inbox-delete are all best-effort; failures are logged but do not block the DB delete. The only way this endpoint returns 500 is if the final DB delete itself fails.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Email account (accounts.id) UUID.

Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Response

Account deleted. External resources cleaned up best-effort; DB row guaranteed removed.

​
success
enum<boolean>
required
Available options:
true