Create stores via the API
Programmatically add new locations to your account.
Last updated April 27, 2026
POST a JSON body to /api/v1/stores to create a new location. Geocoding runs automatically; you do not need to provide coordinates.
curl -X POST https://maptera.switchlabs.dev/api/v1/stores \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "Brooklyn Outlet",
"address": "123 Main St",
"city": "Brooklyn",
"state": "NY",
"postal_code": "11201",
"country": "US",
"phone": "+1 718-555-0100"
}'On success you get a 201 with the full store record including the geocoded latitude and longitude.
For large bulk inserts (hundreds of stores at once), use a small concurrency (4–8) and respect rate limits. See the rate limits article.
Was this article helpful?
Related articles
Did this article miss your question?
Email our team and we will help directly.