Delete contacts
Deletes the named contacts, by ids from upsert_contact or list_contacts, or by emails as the other system has them, compared without case; one of the two, up to 100 per call.
The answer reports every one in the order given: updated with changed: ["is_deleted"] when deleted, unchanged when it was deleted before, failed with contact_not_found when the site has no such contact. A deleted contact disappears from list_contacts and get_contact gives 404. A widget submission, an import, upsert_contact, upsert_contacts or run_automation with the same e-mail restores it with its old data, and it shows up in updated_since again.
Request
- Base URLhttps://api.getsitecontrol.com
- AuthHTTP bearer
Path parameters
Headers
Makes a retry of a POST safe: a repeat with the same key, body and GSC-Version returns the stored response with Idempotency-Replayed: true instead of running again. The key protects against repeated execution while the key store works. Saving the change and storing the response under the key are not atomic: if the process or the key store fails between them, the change is kept, the key is released after 15 minutes and a retry runs the request again. After a timeout or a 5xx, read the resource to check the result before retrying. 5xx and 429 responses and responses over 256 KB are not stored, so a repeat runs the request again. A key is kept for 24 hours. The same key with another body or version is 422; a repeat while the first request runs is 409.
Request body
Example request
{
"emails": [
"ann@example.com"
]
}Response
Successful Response
Changes
No recorded changes to this operation across all 1 revision of this API.