---
title: "Create Notification"
method: PUT
path: "/v3/subscription"
---

# Create Notification

`PUT /v3/subscription`

## Query parameters

- `echo` boolean

## Request body

- object
  - `eventType` string, required — Values: `Chargeback, Deposit, PaymentSuccess, PaymentFail, UpcomingSAQExpiration, RefundCreated, NewStatement, BatchClosed, ExpiredCard`
  - `merchantId` integer, required — Merchant Id
  - `sendEmail` boolean, required — Send email notification
  - `emailAddress` string — Email address to send email notification to
  - `sendSMS` boolean, required — Send text message notification
  - `phoneNumber` string — Phone number to send SMS notification to
  - `sendWebhook` boolean, required — Send webhook notification
  - `callbackUrl` string — URL to send webhook notification to
  - `threshold` integer — Thresholds are required for SAQ expiration and any notification related to dollar amounts.
  - `sources` string — Comma separated list of sources from which to be notified for payments and refunds. This can be QuickPay, Invoice, Recurring, Order, MXExpress, MXRetail, API, and/or Link2Pay.
  - `inviteUsers` string, required — Comma separated list of roles from which to be notified by browser alerts. This can be Administrator, FullAccess, Supervisor, Clerk, ReadOnly. (Can be sent as an empty string)

## Response `200`

200

- object
  - `id` integer
  - `eventType` string
  - `merchantId` integer
  - `created` string
  - `modified` string
  - `phoneNumber` string
  - `threshold` integer
  - `sendEmail` boolean
  - `sendSMS` boolean
  - `sendWebhook` boolean
  - `Sources` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/mxmerchant/apis/checkout-api.md) · [All operations](https://skmtc.net/mxmerchant/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mxmerchant/checkout-api/versions/6807b698abcb/schema)