Delete a contact
A contact still referenced by delivery history is archived instead of removed. archived in the answer tells you which happened, so you are never left guessing why the id still resolves elsewhere.
Try it — DELETE /contacts/{id}
Kept for this tab only — it disappears when you close it, and it is never sent anywhere except as the Authorization header on the call below.
Authorization
bearerAuth contacts:writeAuthorization: Bearer sk_live_.... Keys in the query string or the
request body are refused — a URL is logged by every proxy it passes,
and that is how customer keys leak.
A key carries scopes. A call outside them answers 403 with
insufficient_scope and names the scope it wanted.
In: header
Scope: contacts:write
Path Parameters
The prefixed id of the object.
Header Parameters
Any unique string, one per logical request. Retrying with the same key
returns the first answer instead of doing the work twice, and answers
with Idempotent-Replay: true.
length <= 255Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE https://app.sendkuy.com/api/v1/contacts/con_9cBe3A1H-SLhW5fONWZ32wb-IIio5Ts3 \ -H "Authorization: Bearer sk_live_YOUR_API_KEY"{ "data": { "object": "contact", "id": "string", "deleted": true, "archived": true }}