---
title: "Remove a message template by id."
method: DELETE
path: "/message-templates/{messageTemplateId}"
tags: ["message-templates"]
---

# Remove a message template by id.

`DELETE /message-templates/{messageTemplateId}`

## Request

- Base URL: `https://api.smartrecruiters.com/message-templates-api`
- URL: `https://api.smartrecruiters.com/message-templates-api/message-templates/{messageTemplateId}`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `message_templates_write`

Use this endpoint to remove message template.

## Path parameters

- `messageTemplateId` string, required

## Response `204`

When message template got removed successfully

## Other responses

- `400`: Returned when a request is not valid.
- `401`: Returned when a request was not authenticated.
- `403`: Returned when a caller is not authorized to perform the request.
- `404`: Returned when resource is not found.

---

[API](https://skmtc.dev/smartrecruiters/apis/message-templates-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/message-templates-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/message-templates-api/revisions/52d7dd2c2a76?raw)