Post

Bulk Delete Contacts


Deletes multiple contacts.

All contacts that meet the specified filter and search criteria are deleted. The request should contain a filter value or a search value, or both. To perform a dry run, use the intended filter options with Query Contacts.

When this endpoint is used, a bulk job is started and the job ID is returned. The job might not complete right away, depending on its size. The job's status can be retrieved with Get Bulk Job or List Bulk Jobs.

The following errors can happen while processing the bulk and they will appear in the bulk job:

  • CANNOT_DELETE_SITE_MEMBERS - Contact is a site member and cannot be deleted. Member must be deleted first.
  • CANNOT_DELETE_CONTACT_WITH_BILLING_SUBSCRIPTION - Contact has a valid billing subscription and cannot be deleted.
  • CANNOT_DELETE_MEMBER_OWNER_OR_CONTRIBUTOR - Member cannot be deleted because it is the owner or a contributor. This can happen only if the request indicated to delete the member.
  • FAILED_DELETE_CONTACT_AFTER_MEMBER_DELETION - Member was deleted, but contact was not. This can happen only if the request indicated to delete the member.
  • FAILED_DELETE_CONTACT - Contact could not be deleted.

Permission Scopes

For app development, you must have one of the following permission scopes:
Manage Contacts
Manage Members and Contacts - all permissions
Manage Members
Learn more about permission scopes.
Endpoint
POST
https://www.wixapis.com/contacts/v4/bulk/contacts/delete

Event TriggersThis method triggers the following events:
Was this helpful?
Yes
No