# Subscriptions

**Provider:** Subscriptions
**Category:** payments
**Base URL:** `https://api.hubapi.com/`
**Auth:** api-key — `GET /endpoint?hapikey=YOUR_KEY`
**Rate Limit:** Varies by plan
**Free Tier:** Yes — available
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api.hubapi.com/

## Description

Subscriptions allow contacts to control what forms of communications they receive. Contacts can decide whether they want to receive communication pertaining to a specific topic, brand, or an entire HubSpot account.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.hubapi.com//communication-preferences/v3/definitions` | Get subscription definitions |
| GET | `https://api.hubapi.com//communication-preferences/v3/status/email/{emailAddress}` | Get subscription statuses for a contact |
| POST | `https://api.hubapi.com//communication-preferences/v3/subscribe` | Subscribe a contact |
| POST | `https://api.hubapi.com//communication-preferences/v3/unsubscribe` | Unsubscribe a contact |

## Authentication

API key as a query parameter (hapikey)

```
GET /endpoint?hapikey=YOUR_KEY
```

## Sample Request

```bash
curl -X GET 'https://api.hubapi.com//communication-preferences/v3/definitions' \
  -H 'GET /endpoint?hapikey=YOUR_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Freemium. Subscription management pricing varies by provider; free tiers common.

---

*Source: [API Map](https://apimap.dev/apis/subscriptions/) — CC BY 4.0*