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

# Get a message template by id.

`GET /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_read`

Use this endpoint to fetch a message template.

## Path parameters

- `messageTemplateId` string, required

## Response `200`

Successful response.

- MessageTemplateWithCriteriaPublicDto
  - `template` MessageTemplatePublicDto
    - `id` string
    - `name` string, required
    - `type` 'INTERVIEW_INVITATION' | 'JOB_OFFER' | 'REJECTION' | 'NORMAL_MESSAGE' | 'NEW_APPLICANT_AUTO_RESPOND' | 'NEW_INTERNAL_APPLICANT_AUTO_RESPOND' | 'CAMPAIGN' | 'SELF_SCHEDULE' | 'NORMAL_PROSPECT_MESSAGE' | 'WORKFLOWS_EMAIL_TO_EMPLOYEE' | 'WORKFLOWS_EMAIL_TO_CANDIDATE' | 'GROUP_EVENT_INVITATION' | 'GROUP_EVENT_REMINDER' | 'SESSION_SELF_SCHEDULE_CONFIRMATION' | 'SESSION_MANUAL_SCHEDULE_CONFIRMATION' | 'GROUP_EVENT_CANCELLED' | 'SESSION_MANUAL_RESCHEDULE_CONFIRMATION' | 'SESSION_UPDATE' | 'AUTOMATED_SELF_SCHEDULE_INVITATION' | 'INTERVIEW_INVITATION_CANCEL_NOTIFICATION' | 'SELF_SCHEDULE_CANCEL_NOTIFICATION' | 'INTERVIEW_REMINDER' | 'INVITATION_TO_SELF_SCHEDULE_UPDATED' | 'REQUEST_SELF_RESCHEDULE' | 'AUTOMATED_GROUP_INTERVIEW_INVITATION' | 'AUTOMATED_GROUP_INTERVIEW_REMINDER' | 'AUTOMATED_GROUP_INTERVIEW_CONFIRMATION' | 'GROUP_EVENT_CONFIRMATION', required
    - `companyId` string
    - `channelContent` object
    - `criteriaEnabled` boolean
    - `createDate` string, date-time
    - `updateDate` string, date-time
  - `criteria` CriteriaPublicDto
    - `id` string
    - `active` boolean
    - `companyId` string
    - `refId` string
    - `refType` string
    - `createDate` string, date-time
    - `include` object[]

## Other responses

- `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)