> For the complete documentation index, see [llms.txt](https://p00ls.gitbook.io/token-os/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://p00ls.gitbook.io/token-os/management-api/subscriptions.md).

# Subscriptions

To keep track of users' participation within various campaigns, we use subscriptions.  Before a user can participate in a campaign, they must first subscribe to the campaign.

### The subscription object

This object represents the subscription of a user to a campaign.

### Create subscription

{% openapi src="/files/0xcSTZfwttgKwkRT0eAS" path="/campaigns/{campaignId}/subscriptions" method="post" %}
[creator-api.yaml](https://2025772754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKOyoBDhx8ymvd9xgu92d%2Fuploads%2FV9K5lc6vyEJK4GH14sh4%2Fcreator-api.yaml?alt=media\&token=9ea3d663-0606-4b83-a29c-d9fd58940b29)
{% endopenapi %}

### Retrieve subscription

{% openapi src="/files/0xcSTZfwttgKwkRT0eAS" path="/campaigns/{campaignId}/subscriptions/{userId}" method="get" %}
[creator-api.yaml](https://2025772754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKOyoBDhx8ymvd9xgu92d%2Fuploads%2FV9K5lc6vyEJK4GH14sh4%2Fcreator-api.yaml?alt=media\&token=9ea3d663-0606-4b83-a29c-d9fd58940b29)
{% endopenapi %}