Delete a contact
Delete a contact and their outreach history.
DELETE
/api/v1/contacts/:idScope
contacts:writeDeletes the contact, their outreach history and their place in every list. This can't be undone.
Deleting a contact doesn't put the address on your do-not-email list: if they asked not to be emailed, set their stage to UNSUBSCRIBED instead of deleting them.
Path parameters
Prop
Type
Example request
curl -X DELETE "https://api.pedibee.com/api/v1/contacts/66f1c2a9e4b0a1b2c3d4e5f6" \
-H "Authorization: Bearer $PEDIBEE_API_KEY"Response
{
"deleted": true,
"id": "66f1c2a9e4b0a1b2c3d4e5f6"
}Errors
Every error is { "error": "…" } with a message you can show. See Errors and limits.
| Status | When |
|---|---|
403 | The key doesn’t have contacts:write, or its creator’s role no longer allows it. |
404 | No contact with this id in your workspace. |
401 | The API key is missing, invalid, revoked or expired. |
429 | Too many requests. Wait for the seconds in Retry-After. |