Docs
API · contacts

Delete a contact

Permanently remove a contact and its metadata from the project's address book.

DELETE/v1/contacts/{id}

01 Path parameters

idstringRequired
The contact id to delete.
Deleting is not unsubscribingRemoving a contact does not add them to the suppression list. If the goal is to stop mailing someone, prefer unsubscribe — a deleted contact can be re-created and silently re-mailed.

02 Request

curl -X DELETE https://api.drin.run/v1/contacts/ct_7Yh2Lp \
  -H "Authorization: Bearer $DRIN_API_KEY"

03 Response

Returns 204 No Content with an empty body. An id that is unknown or not visible to this project returns 404 not_found.