---
title: "Send a email or in-app notification"
method: POST
path: "/v1/org/{orgId}/notification"
tags: ["notification"]
---

# Send a email or in-app notification

`POST /v1/org/{orgId}/notification`

## Path parameters

- `orgId` string, required

## Request body

- NotificationRequest
  - `templateName` string, required — name of message template
  - `toUserIds` string[], required — user ids for users to be notified
  - `jobData` NotificationJobData, required
    - `jobId` string
    - `title` string
    - `jobUrl` string, uri
    - `jobProfileUrl` string, uri
    - `atsJobUrl` string, uri
    - `atsJobId` string
    - `atsJobReq` string
    - `atsJobReqField` string
    - `openJobsUrl` string, uri
    - `department` string
    - `location` string
    - `manager` string
    - `backfill` string
    - `hireMgr` string
    - `recruiter` string
    - `recruitPriority` string
    - `recruit` string
    - `sensitive` string
    - `startDate` string, date
    - `estStartDate` string, date
    - `announceDate` string, date
    - `hireName` string
  - `atsName` string — name of the ATS system
  - `orgName` string — name of the organization
  - `userName` string — preferred name of the user
  - `syncSummary` string — summary of reason for email
  - `processId` string — id of the sync history process

## Response `204`

notification sent

## Other responses

- `400` — invalid data
- `401` — not authorized
- `403` — permission denied
- `404` — not found

---

[API](https://skmtc.net/charthop/apis/charthop-api.md) · [All operations](https://skmtc.net/charthop/apis/charthop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/charthop/charthop-api/revisions/33fc84a173ce/schema)