WA.cr APP - API v2
  1. Contacts
WA.cr APP - API v2
  • API v2 Documentation
    • Account
      • Get Account Info
      • Get Usage Statistics
      • Get Plan Limits
    • Authentication (OTP Verification)
      • Send OTP/Verification Code
      • Resend OTP
      • Verify OTP
      • Check OTP Status
      • List Authentication Templates
    • Comments
      • Get Comments
      • Add Comment
    • Contacts
      • List Contacts
        GET
      • Create Contact
        POST
      • Get Contact
        GET
      • Update Contact
        PATCH
      • Delete Contact
        DELETE
      • Batch Create Contacts
        POST
      • Batch Delete Contacts
        DELETE
    • Groups
      • List Groups
      • Create Group
      • Get Group
      • Update Group
      • Delete Group
      • Add Contacts to Group
      • Remove Contacts from Group
    • Messages
      • Send Text Message
      • Send Template Message
      • Send Media Message
      • Send Interactive Message
      • List Messages
      • Get Message
    • Sources
      • List Sources
      • Create Source
      • Get Source
      • Update Source
      • Delete Source
    • Statuses
      • List Statuses
      • Create Status
      • Get Status
      • Update Status
      • Delete Status
    • Templates
      • List Templates
      • Sync Templates from WhatsApp
      • Get Template
  1. Contacts

Batch Delete Contacts

DELETE
/contacts/batch
Delete multiple contacts by their IDs in a single request. Runs inside a database transaction.

Authentication#

Required Scope: contacts:delete

Request Body#

FieldTypeRequiredDescription
idsarrayYesArray of contact IDs (integers) to delete

Response#

Success (200 OK): Returns a summary of the batch delete operation.

Response Data Structure#

FieldTypeDescription
successbooleanWhether the operation succeeded
summary.totalintegerTotal IDs submitted
summary.deletedintegerNumber successfully deleted
summary.failedintegerNumber that failed (IDs not found or not belonging to tenant)
Note: If an ID does not exist or does not belong to the tenant, it is counted as failed (not an error). The operation still succeeds.

Error Responses#

StatusCodeDescription
500INTERNAL_ERRORBatch delete failed (database error, transaction rolled back)

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Responses

🟢200
application/json
Successful response
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE '/contacts/batch' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'
Response Response Example
{}
Modified at 2026-02-25 01:06:20
Previous
Batch Create Contacts
Next
List Groups
Built with