Bulk Contacts

Delete, unsubscribe, or resubscribe multiple contacts in one call.

POST/io/contacts/contacts/bulk

Applies an action to an array of contact IDs owned by the acting user.

Request body

actionstringbodyrequired

delete | unsubscribe | resubscribe

idsstring[]bodyrequired

Array of contact UUIDs. Must be non-empty; non-UUID entries are silently skipped.

{
  "action": "unsubscribe",
  "ids": ["cnt_abc123", "cnt_def456"]
}

{ "affected": 2 }

Authentication

Contact Stats