---
title: "Batch people delete"
method: DELETE
path: "/people/2/persons/batch"
tags: ["customer-engagement", "people", "person-profile"]
---

# Batch people delete

`DELETE /people/2/persons/batch`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/people/2/persons/batch`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`
  - API key in header `Authorization`
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`

Use this method to delete multiple persons.<br>**NOTE** Array size of the batch delete request is limited to `1000` persons.

## Request body

- D0ee6832b8ae2ba6d1bb41f4a297ed26f313a0be247c3016b7bdbb963195d2deBatchDeleteRequest
  - `people` D0ee6832b8ae2ba6d1bb41f4a297ed26f313a0be247c3016b7bdbb963195d2deBatchDeleteEntry[]: List of people.
    - `query` D4672690671974f6265c4d7a3cef5f9272fe4290e9edb608eab676ae3febd3a1IdentityQuery
      - `identifier` string: Person ID. ID type must match the `type` parameter. Some channels (e,g., Apple Business Chat) use identifiers that contain unsafe characters. Make sure you URL-encode them in your API request
      - `sender` string: Sender or application ID. `sender` is required for all identifier types except `ID`, `EXTERNAL_ID`, `PHONE`, `EMAIL`.
      - `type` 'ID' | 'EXTERNAL_ID' | 'PHONE' | 'EMAIL' | 'LINE' | 'FACEBOOK' | 'TELEGRAM' | 'PUSH' | 'WEB_PUSH' | 'LIVE_CHAT' | 'VIBER_BOTS' | 'INSTAGRAM' | 'INSTAGRAM_DM' | 'TWITTER' | 'APPLE_BUSINESS_CHAT' | 'KAKAO_SANGDAM' | 'OPEN_CHANNEL' | 'ZALO_FOLLOWER' | 'TIKTOK_BM' | 'WHATSAPP' | 'KAKAO_TALK'

## Response `200`

successful response

- D0ee6832b8ae2ba6d1bb41f4a297ed26f313a0be247c3016b7bdbb963195d2deBatchDeleteResponse
  - `results` D0ee6832b8ae2ba6d1bb41f4a297ed26f313a0be247c3016b7bdbb963195d2deBatchDeleteResult[]: List of any unsuccessful result from the batch operation for each processed entry. Example, email used in the request already exists.
    - `errors` 3206ab1528b990358dc5d8da723b52b5db6e1d582712d39b5ed66ac5c4b1e84fBatchOperationError[]: List of errors
      - `message` string: Error message
    - `query` D4672690671974f6265c4d7a3cef5f9272fe4290e9edb608eab676ae3febd3a1IdentityQuery
      - `identifier` string: Person ID. ID type must match the `type` parameter. Some channels (e,g., Apple Business Chat) use identifiers that contain unsafe characters. Make sure you URL-encode them in your API request
      - `sender` string: Sender or application ID. `sender` is required for all identifier types except `ID`, `EXTERNAL_ID`, `PHONE`, `EMAIL`.
      - `type` 'ID' | 'EXTERNAL_ID' | 'PHONE' | 'EMAIL' | 'LINE' | 'FACEBOOK' | 'TELEGRAM' | 'PUSH' | 'WEB_PUSH' | 'LIVE_CHAT' | 'VIBER_BOTS' | 'INSTAGRAM' | 'INSTAGRAM_DM' | 'TWITTER' | 'APPLE_BUSINESS_CHAT' | 'KAKAO_SANGDAM' | 'OPEN_CHANNEL' | 'ZALO_FOLLOWER' | 'TIKTOK_BM' | 'WHATSAPP' | 'KAKAO_TALK'
    - `status` integer: HTTP status

## Other responses

- `207`: successful response
- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Server Error
- `4XX`: Error responses
- `5XX`: Error responses

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)