# Create a subscription

> **Open beta feature**
>
> This is an open beta feature, which means you won’t see it available in your organization until you opt in.  If you’re interested in joining this beta, [talk to a Redoxer](https://redoxengine.com/forms/contact-us/) to find out if you’d be a good fit. 

A <u>**subscription**</u> links a source, destination, and data model to define how and what data is exchanged between two organizations. [Learn about subscriptions](https://docs.redoxengine.com/permalink/5k6U4ofmE0bKPBk4fhRcj5/#what-are-subscriptions). We support creating a <u>**one-party subscription**</u>, which means your organization needs to own both the source _and_ destination. 

Specifically, this article is for <u>**cloud connectivity**</u> users who want to hydrate a cloud environment. For non-cloud users, [learn how to request a connection](/how-to-use-redox/manage-your-redox-setup/request-a-connection-or-subscription) instead to expand your integration with a new or existing partner. 

## Prerequisites

- A user must be assigned to an engineer role to create a subscription. [Learn about user roles](/basics/managing-access-for-your-redox-organization/what-are-user-roles). 
- Create a source that sends and normalizes your HL7v2 feed to FHIR. [Learn how to set up sources](/how-to-use-redox/manage-your-redox-setup/set-up-sources).
- Create and verify your cloud destination. [Learn how to set up destinations](/how-to-use-redox/manage-your-redox-setup/set-up-destinations). Your source and cloud destination must be fully configured (i.e., not “<u>**in progress**</u>” status) before you can create a subscription. 

## Create a subscription

Follow these steps to create a new subscription to hydrate your cloud environment. 

1. Log in to the Redox dashboard.
2. From the navigation menu, click the **Connections** page.
3. Click either the **Connected orgs** or **All subscriptions** tab. From either tab, click the **New subscription** button in the top-right corner.


![The New subscription button appears to the right of the connected org name at the top. ](https://images.ctfassets.net/cl3wt5ehhnlv/7wgGWJbIXV5UeZU2wYVKWm/22a7ecaa0c8b531868a8e297ebb9712e/connected-orgs-new-subscription.png)

*New subscription button on the Connected orgs tab*




![The New subscription button appears at the top right of the subscriptions table. ](https://images.ctfassets.net/cl3wt5ehhnlv/Y93c9vbUKwKIz8iOTC7SD/4d99ed80b4b1731a991b025a2939a0cc/all-subscriptions-new-subscription.png)

*The New subscription button on the All subscriptions tab*


4. A modal opens. Fill out these fields: 
   1. <u>Subscription name</u>: Enter a human-readable **name** for the subscription.
   2. <u>Source</u>: From the drop-down options, select the **source** that will initiate the data exchange. 
   3. <u>Destination</u>: From the drop-down options, select the **destination** where the data will be delivered.
   4. <u>Data models</u>: From the list, select **Redox FHIR data model(s)**. Or, you can type in names to filter the list. 
A new subscription is created for each data model you select. In other words, if you select 2 data models, 2 subscriptions are created. You can create up to 6 subscriptions at a time. 


> **What’s a Redox data model?**
>
> As a reminder, a Redox <u>data model</u> is the schema that will be used to normalize data during the exchange. FHIR data models start are prepended with `FHIR`. 

  


> **Unique combinations for subscriptions**
>
> A subscription must have a unique combination of source, destination, and data model. In other words, you can’t have two subscriptions with the same source, destination, and data model.
>
> You could use the same source and destination in multiple subscriptions, but then the data model must be unique.


See these API specs to see a full list of available FHIR data models.
      1. [Redox FHIR API resources](https://docs.redoxengine.com/permalink/fhir-resources-landing-page)
      2. [Redox FHIR notifications](https://docs.redoxengine.com/permalink/fhir-notification-landing-page)
5. Click the **Create** button.


![The Create subscription modal is filled out and ready to create 3 new subscriptions. ](https://images.ctfassets.net/cl3wt5ehhnlv/29vJURYfJhaCZcxvUGCIPM/a6e66d5fb2cbca3e8e7dfb1c58b81842/subscription-create.png)

*Create a new subscription*


6. The new subscription appears in the table. You can edit the subscription name or review any subscription details (including asset links) by clicking the **subscription** name. 
