Skip to main content
GET
/
email
/
public
/
v1
/
subscriptions
Get email subscription types for a Hub ID
curl --request GET \
  --url https://api.hubapi.com/email/public/v1/subscriptions
{
  "subscriptionDefinitions": [
    {
      "active": true,
      "portalId": 12345,
      "description": "The default unsubscribe list that all emails in your hub will use",
      "id": 7,
      "name": "Default"
    },
    {
      "active": true,
      "portalId": 12345,
      "description": "Our weekly newsletter informing you about our new happenings",
      "id": 146,
      "name": "Weekly Newsletter"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://developers.hubspot.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

portalId
integer
required

The HubSpot Portal ID for the portal that you're making the call for.

Response

Email subscription types retrieved successfully

subscriptionDefinitions
object[]
Last modified on March 30, 2026