---
title: "Create a stop template"
method: POST
path: "/api/templates/stop-templates"
tags: ["templates"]
---

# Create a stop template

`POST /api/templates/stop-templates`

## Request

- Base URL: `https://api.vepathos.com`
- URL: `https://api.vepathos.com/api/templates/stop-templates`
- Auth: HTTP bearer

Rejected with 403 once the caller's plan quota (`PlanLimits.maxStopTemplatesPerAccount`) is reached.

## Request body

- StopTemplateInput
  - `name` string, required
  - `description` string
  - `stop` StopTemplateStop, required: Stored as sent. Only `lat` and `lng` are validated; extra fields are kept.
    - `lat` number, required
    - `lng` number, required
    - `address` string
    - `milestoneId` string
    - `twStartMinutes` integer, nullable: Minutes since UTC midnight.
    - `twEndMinutes` integer, nullable: Minutes since UTC midnight.
    - `packages` object[]

## Response `201`

Created stop template.

- StopTemplate
  - `id` string, required
  - `name` string, required
  - `description` string
  - `stop` StopTemplateStop, required: Stored as sent. Only `lat` and `lng` are validated; extra fields are kept.
    - `lat` number, required
    - `lng` number, required
    - `address` string
    - `milestoneId` string
    - `twStartMinutes` integer, nullable: Minutes since UTC midnight.
    - `twEndMinutes` integer, nullable: Minutes since UTC midnight.
    - `packages` object[]
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `400`: Invalid request body
- `401`: Not signed in
- `403`: Plan quota exceeded.

---

[API](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api.md) · [All operations](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vepathos/apis/vepathos-route-optimization-api/revisions/00caa1ca62d9?raw)