Delete lists

Deletes a single or multiple list attributes of a profile.

Please log in to see full path URL. Learn why.

delete

/people/3/lists

Authorizations:

Scopes:

people:manage

Request rate limit:

3 requests / second (per account)

Learn more

query Parameters

listNames required	Array of strings Names of list attributes to delete, separated by commas (,).
type required	string Enum: "ID" "EXTERNAL_ID" "PHONE" "EMAIL" "LINE" "FACEBOOK" "TELEGRAM" "PUSH" "LIVE_CHAT" "VIBER_BOTS" "INSTAGRAM" "INSTAGRAM_DM" "TWITTER" "APPLE_BUSINESS_CHAT" "KAKAO_SANGDAM" "OPEN_CHANNEL" Type of the person ID. Can be one of the above.
identifier required	string Person ID. ID type must match the `type` parameter.
sender	string Sender or application ID.`sender` is required for all identifier types except `ID`, `EXTERNAL_ID`, `PHONE`, `EMAIL`

Responses

204

Success

400

Bad request

401

Unauthorized

403

Forbidden

404

Not found

429

Too Many Requests

500

Internal Server Error

Request samples

Example

cURL

Copy

curl -L -g -X DELETE 'https://{baseUrl}/people/3/lists?listNames=%7BlistNames%7D&type=%7Btype%7D&identifier=%7Bidentifier%7D' \
-H 'Authorization: {authorization}' \
-H 'Accept: application/json'

Response samples

Content type

application/json

Example

identifier is not provided

Copy

Collapse all


{"errorCode": 400116,
"message": "Missing parameter: identifier"
}

Need assistance

Explore Infobip Tutorials

Encountering issues

Contact our support

What's new? Check out

Release Notes

Unsure about a term? See

Glossary

Research panel

Help shape the future of our products

Learn more

Service status

Privacy documents Terms of use