Skip to main content

Send Subscription Status

POST 
/subscriptions/:id/status

Sends subscription status information to the customer through their preferred communication channel.

This API can only be used for subscriptions with the following statuses:

  • Active
  • Trialing
  • Past due

Delivery channels are automatically selected based on available customer information:

  • If customer email is available: Status is sent via email
  • If customer phone is available: Status is sent via WhatsApp
  • If WhatsApp delivery fails: Status is sent via SMS as a fallback

The status notification includes subscription details such as current status, upcoming payments, and recent changes. If no customer contact information is provided, the system will use the details stored in the subscription record.

Email notifications include contextual action links based on subscription status:

  • For past due subscriptions: A link to reactivate the subscription
  • For active and trialing subscriptions: A link to update the payment method

You can specify the customer's email or phone number, the preferred communication channel (email or SMS), and the language for the message.

Request​

Responses​

A subscription object