# Set up destinations

You must set up standard endpoint(s) and/or cloud destination(s) to receive data from Redox. [Learn more about receiving data](/basics/data-exchange-with-redox/receiving-data-from-redox).

## Prerequisites

- A user must be assigned to an <u>**engineer role**</u> to manage destinations. [Learn about user roles](/basics/managing-access-for-your-redox-organization/what-are-user-roles).
- _For cloud destinations_, decide on which supported cloud product(s) you’ll use. [See our supported products](/how-to-use-redox/manage-cloud-connectivity).
- _For standard URL endpoints_, have your HTTPS endpoint URL ready. 
- (Optional) [Create an auth credential](/how-to-use-redox/manage-your-redox-setup/set-up-auth-credentials) or verification token to authenticate incoming data. Otherwise, you can do this in the destination wizard. 
- To delete a destination, you must be logged into a <u>development</u> or <u>staging</u> environment. <u>Production</u> destinations can’t be deleted without a Redoxer.

## View destinations

Follow these steps to view any existing destinations, or endpoints. 

1. Log in to the Redox dashboard.
2. From the navigation menu, click the **Developer** page.
3. By default, the <u>Sources</u> tab opens. Click the **Destinations** tab to view any configured destinations. 
4. To view a specific destination’s configuration details, click the **destination** **row** in the table. 

## Create a destination

On the <u>Destinations</u> tab, click the **New** button \> **New destination** option to open the destination wizard. The instructions below take you through each step of the destination wizard. 

![The New button is on the top right of the Destinations tab.](https://images.ctfassets.net/cl3wt5ehhnlv/4QBjVYHMNPnzs5imYwYG6b/55e9d2914a499f7c23e9e57b9cf81e84/destinations-new-option.png)

*Create a new destination*

> **Save progress and exit**
>
> You can exit the destination wizard at any time. If you’ve already started entering destination settings, you can click the **Save progress** option to save what you’ve done so far and exit the wizard. 
>
> The new destination will appear on the <u>Destinations</u> tab with a status of <u>in progress</u>. Edit the destination to complete setup at any time.

### Step 1: Select destination type

1. Enter a human-readable **name** for the destination. This will be the display name on the <u>Destinations</u> tab. 


> **Destination names**
>
> There aren’t any restrictions around destination names. That means you could end up with duplicate names.
>
> We recommend creating unique, descriptive names so you can more easily distinguish between destinations.




![A user enters a name for the new destination.](https://images.ctfassets.net/cl3wt5ehhnlv/4VowQafvZLiZcyIWFwPdoC/a3daaff9d4a963ed406f1e07472c0bf9/destination-wizard-step-1.gif)

*Create a new destination*


2. From the <u>Destination type</u> drop-down field, select whether your destination will be a **standard URL endpoint** or **cloud** type. 
   - For standard URL endpoints, click the **Next** button to proceed to <u>Step 2: Configure destination</u>. 
   - For cloud types, these drop-down fields appear: 
     1. <u>Cloud provider</u>: Select the relevant **cloud provider** for your setup (i.e., AWS, GCP, or Microsoft Azure).
     2. <u>Product type</u>: Select the **cloud product** you’re using with the selected cloud provider. 
     3. Click the **Next** button to proceed to <u>Step 2: Configure destination</u>.


> **Can’t edit destination types**
>
> After completing the first two steps in the destination wizard (i.e., destination type and configuration details), the destination type fields become uneditable. Even if you click the **Back** button or **Edit** button later, the destination type fields will be read-only. The destination configuration details can still be edited, however.
>
> If you need to edit a destination’s type or cloud product(s), we recommend deleting the existing one and creating a new destination instead.




![A user selects the cloud destination type and additional cloud settings appear.](https://images.ctfassets.net/cl3wt5ehhnlv/4HQO6WnPmE944pROYHVLWO/3bc9e7568bf0f9c355bd705188e4d985/Destination-cloud-type__1_.gif)

*Create a cloud destination*



### Step 2: Configure destination

#### Option 1: Standard URL endpoint

1. In the <u>Endpoint</u> field, enter the **URL endpoint**. This must be an HTTPS URL.
2. Click the **Next** button to proceed to <u>Step 3: Configure auth credential</u>.


![A user enters a valid endpoint URL for a standard destination.](https://images.ctfassets.net/cl3wt5ehhnlv/1U3G8uFlh7Rzl0AqNUEidm/cf0b3acdbb7df5f1be76ca917e948f5f/Destination-standard-endpoint-URL__1_.gif)

*Enter the endpoint URL*



#### Option 2: Cloud provider destination

1. Depending on your selected cloud provider and product type, the set of configuration fields will be different. [Check out the relevant how-to](/how-to-use-redox/manage-cloud-connectivity) for your cloud setup. You’ll find details about auth credentials in each of these how-tos as well. 
2. Click the **Next** button, then proceed to <u>Step 4: Verify destination</u>.

### Step 3: Configure auth credential

The <u>Attach an auth credential</u> drop-down appears. 

#### Option 1: Use an existing auth credential

1. Select the **auth credential** from the drop-down list. 
2. Click the **Next** button to proceed to <u>Step 4: Verify destination</u>.


![A user selects an existing auth credential in the destination wizard.](https://images.ctfassets.net/cl3wt5ehhnlv/34CVVFLA0bjVFYJ7FWzqio/b32928b4226c987d846dffe0e5277f27/Destination-attach-auth-credential__1_.gif)

*Attach an existing auth credential*



#### Option 2: Create a new auth credential or use a verification token

1. Click the **plus (+) icon** to the right of the field.  


![A user clicks the plus icon to add a new auth credential, then selects the verification token radio option.](https://images.ctfassets.net/cl3wt5ehhnlv/536qk30Ngx4LrQJEEMkyde/b119ff226ad850a3203815213601dc7f/Destinations-create-new-auth-cred__1_.gif)

*Use new auth credential or verification token*


2. Radio options appear. Select the **Verification token** or **Auth credential** radio button, depending on which authentication method you want to use for your destination. 
   - <u>Verification token</u>: Enter the verification token in the blank field.


> **Verification token**
>
> The verification token is a value you decide. Treat it like a password. We recommend using a unique, long alphanumeric string value that’s difficult to brute force or guess.
>
> Redox uses that value in the `verification-token` header of every inbound request to your destination. Your system must check this header to verify the legitimacy of the inbound request. 


   - <u>Auth credential</u>: Enter a unique, human-readable name, then fill out the rest of the configuration depending on your selected auth strategy. [Learn how to create an auth credential](/how-to-use-redox/manage-your-redox-setup/set-up-auth-credentials).   
3. Click the **Next** button to proceed to <u>Step 4: Verify destination</u>.

### Step 4: Verify destination

> **Skip verification**
>
> You can skip the verification step for <u>**production**</u> destinations if you don’t want test data in a <u>**production**</u> environment. Simply click the **Skip verification** checkbox, then click the **Complete setup** button to finish setting up your production destination.
>
> ![](https://images.ctfassets.net/cl3wt5ehhnlv/6JLGTZpsL0U18SblRGAM5E/d6f5c1f8df3bde3a19db9f39793e2faa/Destinations_skip-verification.png)

1. In the <u>Data Model</u> drop-down, select a test **data model** or **FHIR message** you support and plan to receive. 


> **FHIR data model format**
>
> If you’re sending data to a cloud FHIR store, you should pick a data model that starts with `FHIR.Event.<FHIR-resource-or-notification>`.


2. Click the **Send** button. This triggers a sample message to verify that your destination can receive the expected data from Redox. 
3. If the test message is successful, you should receive a `200` response. Click the **Complete setup** button to close the wizard. 
If the test message isn’t successful, you won’t be able to finish the setup of <u>development</u> or <u>staging</u> destinations. Make sure your endpoint URL adheres to Redox requirements, then try again. Otherwise, [check out verification troubleshooting tips](/troubleshooting/troubleshoot-verification-errors-for-an-endpoint).


> **Endpoint requirements**
>
> To successfully exchange data, your endpoint(s) must:
>
> - be publicly accessible from the internet;
> - accept POST requests;
> - use SSL/TLS encryption (not relevant to development environments); and
> - check the verification token of every incoming request.



## Edit a destination

You can edit some destination details, as well as the preferred authentication method for the destination.

> **Can’t edit destination types**
>
> After completing the first two steps in the destination wizard (i.e., destination type and configuration details), the destination type fields become uneditable. Even if you click the **Back** button or **Edit** button later, the destination type fields will be read-only. The destination configuration details can still be edited, however.
>
> If you need to edit a destination’s type or cloud product(s), we recommend deleting the existing one and creating a new destination instead.

1. Follow the steps to view destinations.
2. Find the destination you want to edit and click anywhere in its **row.** 
3. The <u>Details</u> page opens. Under the <u>Destination details</u> section, click the **Edit** button. 
4. Depending on the destination type, different fields become editable. Make any changes, then click the **Save** button.


![A user edits the destination name of an API source in their organization.](https://images.ctfassets.net/cl3wt5ehhnlv/7Mxa7G691WYEqWP46VRiJv/c6962deced2126f8b683ce0bce80e47f/destinations-edit.gif)

*Edit a destination*



## Delete a destination

1. Follow the steps to view destinations.
2. Find the destination you want to delete and click anywhere in its **row.** 
3. The <u>Details</u> page opens. Click the **Delete** button in the top-right corner.


> **Can’t delete production destination**
>
> You can’t delete a production destination without a Redoxer’s help. Talk to your Technical Account Manager if you need to delete a destination in a production environment.




![A user deletes a test source.](https://images.ctfassets.net/cl3wt5ehhnlv/6LCMudWPPs3CFFa0ZJnZ9U/2144ca64023f0e804d12c4220f1a5829/destinations-delete.gif)

*Delete a destination*


4. A modal appears asking you to confirm the deletion. Click the **Delete** button to confirm—or the **Cancel** button if you changed your mind. 

> **Platform API endpoints**
>
> This article describes how to manage destinations in the <u>**Redox dashboard**</u>. To manage destinations via <u>API</u>, use these <u>**Redox Platform API**</u> endpoints instead:
>
> - [Create destination](https://docs.redoxengine.com/permalink/96830826-bf9c-5d5a-878c-b5b3f1402f30-create-destination)
> - [Update destination](https://docs.redoxengine.com/permalink/aff09099-20eb-5e41-bae8-5868d31078aa-update-destination)
> - [Verify destination](https://docs.redoxengine.com/permalink/035df9d9-f4d9-52bf-9e7a-e7851ecf5866-verify-destination)
> - [Run dataset tester](https://docs.redoxengine.com/permalink/1ef24983-81b5-5643-921e-9e4cecef3284-run-dataset-tester)
> - [Delete destination](https://docs.redoxengine.com/permalink/479b7888-b8b2-583b-81d4-54b7d813d352-delete-destination)
