---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/api/errors/19031#article
headline: "19031: Maximum number of locations allowed reached "
url: https://www.twilio.com/docs/api/errors/19031
inLanguage: en
dateModified: 2026-06-08T11:29:20.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 19031: Maximum number of locations allowed reached 

Log Type: APPLICATION

Log Level: ERROR

## Description

This error occurs when your request tries to create more than five locations for a single contact. Reduce the total number of locations in the contact payload before you retry the request.

### Possible causes

* The request body includes more than five location objects for one contact.
* The contact already has five saved locations and the request tries to add another one.
* A bulk upsert request adds locations to an existing contact and pushes the total above the five-location limit.

### Possible solutions

* Send no more than five locations for each contact.
* Remove an existing location before you add a new one.
* Review the full contact payload before you retry the request and remove duplicate, outdated, or unnecessary locations.
* If you update contacts in bulk, validate the final number of locations for each contact so the combined total does not exceed five.

#### Additional resources

* [Contact API](/docs/messaging/features/contact-api)
* [Compliance Toolkit for Programmable Messaging](/docs/messaging/features/compliance-toolkit)
* [Consent Management API](/docs/messaging/features/consent-api)