> ## Documentation Index
> Fetch the complete documentation index at: https://doc-test-my.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Send or Resend Notifications

> Send or Resend notifications to your customers via email and SMS using this endpoint.

Use this endpoint to send or resend notifications to your customers via email and SMS.

<RequestExample>
  ```bash Curl theme={null}
  curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -X POST https://api.razorpay.com/v1/payment_links/plink_Et2G7ymGcTTuM5/notify_by/sms \
  ```

  ```php PHP theme={null}
  $api = new Api($key_id, $secret);

  $api->paymentLink->fetch($paymentLinkId)->notifyBy($medium));
  ```

  ```javascript Node.js theme={null}
  var instance = new Razorpay({ key_id: 'YOUR_KEY_ID', key_secret: 'YOUR_SECRET' })

  instance.paymentLink.notifyBy(paymentLinkId, medium)
  ```

  ```python Python theme={null}
  import razorpay
  client = razorpay.Client(auth=("YOUR_ID", "YOUR_SECRET"))

  client.payment_link.notifyBy(paymentLinkId, medium)
  ```

  ```go Go theme={null}
  import ( razorpay "github.com/razorpay/razorpay-go" )
  client := razorpay.NewClient("YOUR_KEY_ID", "YOUR_SECRET")

  body, err := client.PaymentLink.NotifyBy("<paymentLinkId>", "<medium>", nil, nil)
  ```

  ```ruby Ruby theme={null}
  require "razorpay"
  Razorpay.setup('key_id', 'key_secret')

  paymentLinkId = "plink_ExjpAUN3gVHrPJ"

  medium = "email"

  Razorpay::PaymentLink.notify_by(paymentLinkId, medium)
  ```

  ```java Java theme={null}
  import org.json.JSONObject;
  import com.razorpay.Payment;
  import com.razorpay.RazorpayClient;
  import com.razorpay.RazorpayException;

  RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
  String paymentLinkId = "plink_FMbhpT6nqDjDei";

  String medium = "email";

  PaymentLink paymentlink = razorpay.paymentLink.notifyBy(paymentLinkId,medium);
  ```

  ```csharp .NET theme={null}
  RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  string paymentLinkId = "plink_Z6t7VFTb9xHeOs";

  string  = "email";

  PaymentLink paymentlink = client.PaymentLink.Fetch(paymentLinkId).NotifyBy(medium);
  ```

  ```bash CLI theme={null}
  # Via SMS
  razorpay payment-links notify plink_ABC123 --medium sms

  # Via email
  razorpay payment-links notify plink_ABC123 --medium email
  ```

  ```bash Curl theme={null}
  curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -X POST https://api.razorpay.com/v1/payment_links/plink_Et2G7ymGcTTuM5/notify_by/sms \
  ```

  ```php PHP theme={null}
  $api = new Api($key_id, $secret);

  $api->paymentLink->fetch($paymentLinkId)->notifyBy($medium));
  ```

  ```java Java theme={null}
  import org.json.JSONObject;
  import com.razorpay.Payment;
  import com.razorpay.RazorpayClient;
  import com.razorpay.RazorpayException;

  RazorpayClient razorpay = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");
  String paymentLinkId = "plink_FMbhpT6nqDjDei";

  String medium = "email";

  PaymentLink paymentlink = razorpay.paymentLink.notifyBy(paymentLinkId,medium);
  ```

  ```csharp .NET theme={null}
  RazorpayClient client = new RazorpayClient("[YOUR_KEY_ID]", "[YOUR_KEY_SECRET]");

  string paymentLinkId = "plink_Z6t7VFTb9xHeOs";

  string  = "email";

  PaymentLink paymentlink = client.PaymentLink.Fetch(paymentLinkId).NotifyBy(medium);
  ```

  ```bash CLI theme={null}
  # Via SMS
  razorpay payment-links notify plink_ABC123 --medium sms

  # Via email
  razorpay payment-links notify plink_ABC123 --medium email
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
      "success": true
  }
  ```

  ```json Failure theme={null}
  {
    "error": {
      "code": "BAD_REQUEST_ERROR",
      "description": "invalid input [id] = [link_QX7wiVUHdcOOoW]",
      "metadata": [],
      "reason": null,
      "source": null,
      "step": null
    }
  }
  ```
</ResponseExample>

## Path Parameters

<ParamField path="id" type="string" required>
  Unique identifier of the Payment Link that should be resent.
</ParamField>

<ParamField path="medium" type="string" required>
  Medium through which the Payment Link must be resent. Possible values:

  * `sms`
  * `email`
</ParamField>

## Response Parameters

<ResponseField name="success" type="boolean">
  Indicates whether the notification was sent successfully. Possible value is `true`, which means the notification was sent successfully.
</ResponseField>

## Errors

<AccordionGroup>
  <Accordion title="not a valid notification medium">
    **Code:** `400`

    Occurs when you try to resend a Payment Link to customers and medium of notification is not valid.

    **Solution:** Ensure that you use the correct medium to resend a payment link.
  </Accordion>

  <Accordion title="The id provided does not exist.">
    **Code:** `400`

    The Payment Link id passed in the URL does not exist or does not belong to the requesting merchant.

    **Solution:** Use a valid Payment Link id returned from `POST /v1/payment_links`. Confirm by fetching the link before retrying.
  </Accordion>

  <Accordion title="Length of id should be exactly 14.">
    **Code:** `400`

    The Payment Link id in the URL is not 14 characters long (excluding the `plink_` prefix). Razorpay-issued ids are always exactly 14 characters.

    **Solution:** Use the Payment Link id exactly as it was returned in the create response (for example, `plink_HZbgjy1cnaCFqM`).
  </Accordion>

  <Accordion title="Request rate limit exceeded. Please try again later.">
    **Code:** `429`

    You have exceeded the per-link / per-medium notification rate limit. Razorpay caps how often the same notification can be re-sent for a given Payment Link.

    **Solution:** Wait a short while before retrying. If you need a higher sustained rate, contact [Razorpay support](https://razorpay.com/support/).
  </Accordion>
</AccordionGroup>