Skip to main content

contactDeleteBulk

Remove several contacts in one request.

Each id is deleted exactly as contactDelete would delete it, and every deleted contact emits its own event. Login accounts are not touched — this removes contact records, as the single delete does.

An id that cannot be deleted does not fail the request. It lands in failedIds with an entry in failures saying why, and the rest of the batch is deleted regardless. Repeated ids are collapsed, so an id sent twice gets one verdict.

Read failures[].reason before offering a retry: only CONTACT_DELETE_ERROR describes something a repeat could fix.

Possible errors:

  • INVALID_INPUT: The list of ids was empty.

AUTH: Role=[user.OWNER]

contactDeleteBulk(
ids: [Int!]!
): ContactBulkDeleteResponse!

Arguments

contactDeleteBulk.ids ● [Int!]! non-null scalar

Numeric identifiers of the contacts to delete. Recommended maximum: 100 per request — advisory, not enforced.

Type

ContactBulkDeleteResponse object