Skip to main content
GET
/
v1
/
channels
/
{channelId}
/
subscribe
Subscribe channel (ENTERPRISE)
curl --request GET \
  --url https://api.hubmessage.io/v1/channels/{channelId}/subscribe \
  --header 'Authorization: Bearer <token>'
{
  "type": "SUBSCRIPTION_UPDATED",
  "message": "Channel active. Prorated charge will be included in the next invoice."
}

Overview

Links a channel to the account’s active Stripe subscription. The channel is automatically added to the existing subscription and a prorated charge for the remaining billing period is included on the next invoice.
Payment is completed beforehand by the user in the dashboard. This endpoint should be called after the checkout is completed in the dashboard to activate the channel via API.
This endpoint requires the ENTERPRISE role on your account.
Example response:
{
  "type": "SUBSCRIPTION_UPDATED",
  "message": "Channel active. Prorated charge will be included on the next invoice."
}
The channelId is obtained from the Create channel endpoint.

Authorizations

Authorization
string
header
required

Secret Key generated in the Hub Message Security panel

Path Parameters

channelId
string
required

Channel ID (obtained via Create channel)

Example:

"019E4C54B1B375A28970B605CA9B03C3"

Response

Channel linked to subscription successfully

type
enum<string>

Indicates the channel was successfully added to the subscription

Available options:
SUBSCRIPTION_UPDATED
Example:

"SUBSCRIPTION_UPDATED"

message
string

Informational message to display to the user

Example:

"Channel active. Prorated charge will be included in the next invoice."