# Send subscription link

Use a subscription link when you want the customer to activate a subscription without building a checkout flow on your website. Your back office creates the subscription, then asks MONEI to send the activation link by email or SMS. The customer opens the link, completes the initial payment on a MONEI-hosted page, and the subscription becomes active.

This is useful for manual or back-office subscription creation, where you do not need a full customer-facing integration but still want to trigger the activation link from your system.

## Before you begin[​](#before-you-begin "Direct link to Before you begin")

* Create the subscription first using the [create subscription](https://docs.monei.com/apis/rest/subscriptions-create/.md) endpoint.
* Make sure the subscription has the customer details you need for your flow.
* Decide how to deliver the link: use `customerEmail` to send it by email, or `customerPhone` to send it by SMS.

## Send the activation link[​](#send-the-activation-link "Direct link to Send the activation link")

The examples below send the activation link by email. To send the link by SMS, use `customerPhone` instead of `customerEmail`.

* cURL
* Node.js
* PHP
* Python

POST https\://api.monei.com/v1/subscriptions/{id}/link

```
curl --request POST 'https://api.monei.com/v1/subscriptions/YOUR_SUBSCRIPTION_ID/link' \

--header 'Authorization: YOUR_API_KEY' \

--header 'Content-Type: application/json' \

--data-raw '{

  "customerEmail": "john.doe@example.com"

}'
```

server.js

```
const subscription = await monei.subscriptions.sendLink('YOUR_SUBSCRIPTION_ID', {

  customerEmail: 'john.doe@example.com'

});
```

server.php

```
<?php

use Monei\Model\SendSubscriptionLinkRequest;



$subscription = $monei->subscriptions->sendLink(

  'YOUR_SUBSCRIPTION_ID',

  new SendSubscriptionLinkRequest([

    'customer_email' => 'john.doe@example.com'

  ])

);

?>
```

server.py

```
from Monei import SendSubscriptionLinkRequest



subscription = monei.subscriptions.send_link(

    "YOUR_SUBSCRIPTION_ID",

    SendSubscriptionLinkRequest(

        customer_email="john.doe@example.com"

    )

)
```

After the customer opens the link and completes the initial payment, the subscription becomes active and recurring billing starts according to the subscription interval.

## Send the link from the Dashboard[​](#from-the-dashboard "Direct link to Send the link from the Dashboard")

You don't have to call the API to send the link. To send it by hand:

1. Open the subscription in [MONEI Dashboard → Subscriptions](https://dashboard.monei.com/subscriptions).
2. Click **Send subscription link**.
3. Choose the **Delivery channel** — Email, WhatsApp, or SMS — and enter the address or phone number to send it to. If the phone number is not registered in WhatsApp, the customer gets the link by SMS instead.
4. Choose the **Customer language**. It sets the language of the message the customer receives, not the language of your dashboard.
5. Check the **Email preview**, then click **Send subscription link**.

![Send subscription link dialog in the MONEI Dashboard, with the delivery channel, the address to send to, the customer language and a preview of the email](/img/dashboard/en/subscription-send-link.png)

Send subscription link dialog in the MONEI Dashboard, with the delivery channel, the address to send to, the customer language and a preview of the email