> ## Documentation Index > Fetch the complete documentation index at: https://detrack.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Bulk create depots > POST /dn/depots/bulk creates multiple depots at once. Each entry needs a name and geocodable address; the API returns geocoded data for all. Create multiple depot locations in a single call. Each entry in the request array must include at least a `name` and an `address` that the platform can geocode. The API processes up to 100 entries per request. If a depot with the same `name` already exists, that entry updates it instead of creating a duplicate. The response returns the full depot objects with assigned `id` values and geocoded coordinates for every successfully created depot. For updating or deleting multiple depots, see [Bulk update](/api-reference/depots/bulk-update) or [Bulk delete](/api-reference/depots/bulk-delete). ## OpenAPI ````yaml POST /dn/depots/bulk openapi: 3.0.3 info: title: Detrack REST API v2 version: '2.0' description: >- Detrack REST API v2. Checked against detrack-webapp origin/main (production) on 2026-09-29: dn_jobs.rb @ d246ad006, dn_depots.rb @ 2a5f387, dn_routes.rb @ 50a73a9, app_helper.rb @ d745ad2, dn_jobs_helper.rb @ d296e30, job_decorator.rb @ 3041da7, run_location_decorator.rb @ 0f0274d, vehicle_route_plan_decorator.rb and tsp_route_decorator.rb @ 7d1f3ef, data_export.rb @ ed4e135. servers: - url: https://app.detrack.com/api/v2 security: - apiKey: [] tags: - name: Jobs description: Deliveries and collections. - name: Depots description: Saved warehouse and pickup locations. - name: Routes description: Optimized multi-stop plans across vehicles. paths: /dn/depots/bulk: post: tags: - Depots summary: Bulk create depots description: >- Creates up to 100 depots. An existing depot with the same `name` is updated instead. operationId: bulkCreateDepots requestBody: required: true content: application/json: schema: type: object required: - data properties: data: type: array description: >- Only the first 100 items are processed. Any beyond that are ignored without an error. items: $ref: '#/components/schemas/DepotInput' responses: '201': description: Every depot was saved. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/Depot' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '422': description: >- Some depots failed validation. The others are still saved and appear under `data.data`. content: application/json: schema: type: object properties: code: type: string example: validation_failed message: type: string example: Validation failed errors: type: array items: type: object properties: name: type: string example: Depot 2 errors: type: array items: type: string example: - Address can't be blank data: type: object properties: data: type: array items: $ref: '#/components/schemas/Depot' default: $ref: '#/components/responses/ServerError' components: schemas: DepotInput: type: object required: - name - address properties: name: type: string description: Depot name. An existing depot with the same name is updated. example: Main Depot address: type: string description: Full address that can be geocoded. example: SM Mall of Asia, Seaside Blvd, Pasay, Metro Manila addr_1: type: string addr_2: type: string addr_3: type: string zip_code: type: string city: type: string state: type: string Depot: type: object properties: id: type: string readOnly: true example: 68f0d416e8ec54cbf4a04dba name: type: string example: Main Depot address: type: string example: >- SM Megamall, EDSA corner Doña Julia Vargas Ave, Mandaluyong, 1550 Metro Manila addr_1: type: string nullable: true addr_2: type: string nullable: true addr_3: type: string nullable: true zip_code: type: string nullable: true country: type: string nullable: true city: type: string nullable: true state: type: string nullable: true country_id: type: string nullable: true readOnly: true location: type: array readOnly: true description: Coordinates as `[longitude, latitude]`. items: type: number example: - 121.055626 - 14.583941 address_lat: type: number readOnly: true example: 14.583941 address_lng: type: number readOnly: true example: 121.055626 Error: type: object properties: code: type: string example: not_found message: type: string example: Could not find job with this DO number responses: BadRequest: description: The request body isn't valid JSON. content: application/json: schema: $ref: '#/components/schemas/Error' example: code: invalid_json_format Unauthorized: description: >- The API key is missing or invalid. A missing `X-API-KEY` returns `{ "error": "Missing Authorization header" }`; an invalid key returns `{ "code": "invalid_key", "message": "Invalid key" }`. content: application/json: schema: oneOf: - type: object title: Missing key required: - error properties: error: type: string example: Missing Authorization header - type: object title: Invalid key required: - code properties: code: type: string example: invalid_key message: type: string example: Invalid key example: code: invalid_key message: Invalid key Forbidden: description: Your API key's user doesn't have permission for this action. content: application/json: schema: type: object properties: code: type: string example: forbidden example: code: forbidden ServerError: description: >- Unexpected server error. Retry with exponential backoff, and contact Detrack support if it persists. securitySchemes: apiKey: type: apiKey in: header name: X-API-KEY description: Your Detrack API key, from **Integrations > API Key** in the dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.