# Set up HubSpot authorization for Postman Flows

To run Postman Flows templates that use HubSpot, you need to set up authorization between HubSpot and Postman. You can do this by creating a private app in HubSpot and storing its access token as an environment [variable](/docs/sending-requests/variables/variables-intro/) in Postman.

<Info class="iconless-callout">
  If you plan to use flow templates that use HubSpot with Stripe, more configuration is required. See [Create custom properties for Stripe](#create-custom-properties-for-stripe).
</Info>

Before you get started, you need:

* A [HubSpot](https://www.hubspot.com/) account
* A Postman [environment](/docs/sending-requests/variables/managing-environments/) to run the flow

## Create a private HubSpot app

To create and configure a private HubSpot app to use with Postman Flows, do the following:

1. Log in to your [HubSpot](https://www.hubspot.com/) account.

2. Navigate to **Settings > Integrations > Private Apps**, and then select **Create a private app**. For detailed instructions, see the [HubSpot documentation](https://developers.hubspot.com/beta-docs/guides/apps/private-apps/overview).

3. Select the **Scopes** tab, and then select **Add new scope**.

4. Select the checkboxes for the following scopes, based on the HubSpot events you want the flow to access:

   | **Events**                     | **Scope**                   |
   | ------------------------------ | --------------------------- |
   | New contacts, form submissions | `crm.objects.contacts.read` |
   | New deals                      | `crm.objects.deals.read`    |
   | New tickets                    | `tickets`                   |

5. Select **Update**.

6. Select the checkboxes for the following subscriptions, based on the HubSpot events you want the flow to access:

   | **Events**                     | **Scope**          |
   | ------------------------------ | ------------------ |
   | New contacts, form submissions | `contact.creation` |
   | New deals                      | `deal.creation`    |
   | New tickets                    | `ticket.creation`  |

7. Select **Create app**.

8. After your app is created, select the app and navigate to **Auth**.

9. Select **Show token** to reveal your app's access token. Select **Copy**, and then save it as a variable in your Postman environment named `HubSpot_Access_Token`.

## Create custom properties for Stripe

To configure HubSpot to process data from Stripe, create new properties in HubSpot based on the flows you plan to run.

### Add new Stripe customers to HubSpot

To configure HubSpot to process data from Stripe about new customers, do the following:

1. In HubSpot, navigate to **Settings > Properties**.

2. Select **Contact properties > Create property**.

3. Create the following custom property:

   | **Property name** | **Field type**   |
   | ----------------- | ---------------- |
   | `stripe_id`       | Single-line text |

### Add new Stripe subscriptions to HubSpot contacts list

To configure HubSpot to process data from Stripe about new subscriptions, do the following:

1. In HubSpot, navigate to **Settings > Properties**.

2. Select **Contact properties > Create property**.

3. Create the following custom property:

   | **Property name** | **Field type**   |
   | ----------------- | ---------------- |
   | `stripe_id`       | Single-line text |

4. Navigate to **CRM > Lists > Create List**.

5. Select **Static list**. Enter a name for the list and then save.

6. After saving, open the list details and locate the **List ID**.

7. Copy the ID, and then save it as a variable named `HubSpot_Contact_List_ID` in your Postman environment.

### Create HubSpot deals for new Stripe invoices

To configure HubSpot to process data from Stripe about new invoices, do the following:

1. In HubSpot, navigate to **Settings > Properties**.

2. Select **Contact properties > Create property**.

3. Create the following custom property:

   | **Property name**    | **Field type**   |
   | -------------------- | ---------------- |
   | `stripe_customer_id` | Single-line text |

4. Select **Deal properties > Create property**.

5. Create the following custom properties:

   | **Property name**          | **Field type**   |
   | -------------------------- | ---------------- |
   | `stripe_collection_method` | Single-line text |
   | `stripe_currency`          | Single-line text |
   | `stripe_period_end`        | Date picker      |
   | `stripe_period_start`      | Date picker      |
   | `stripe_total`             | Number           |
   | `stripe_customer_email`    | Single-line text |

### Create or update HubSpot contacts for new Stripe subscriptions

To configure HubSpot to process data from Stripe about new subscriptions, do the following:

1. In HubSpot, navigate to **Settings > Properties**.

2. Select **Contact properties > Create property**.

3. Create the following custom property:

   | **Property name** | **Field type**   |
   | ----------------- | ---------------- |
   | `stripe_id`       | Single-line text |

### Create or update HubSpot contacts with new Stripe payments

To configure HubSpot to process data from Stripe about new payments, do the following:

1. In HubSpot, navigate to **Settings > Properties**.

2. Select **Contact properties > Create property**.

3. Create the following custom properties:

   | **Property name**    | **Field type**   |
   | -------------------- | ---------------- |
   | `stripe_id`          | Single-line text |
   | `stripe_customer_id` | Single-line text |
   | `stripe_currency`    | Single-line text |
   | `stripe_amount`      | Number           |

## Next steps

After you've completed your HubSpot configuration, you can return to the flow template or set up authorization for another integration in Postman.

* [Set up Mailchimp authorization for Postman Flows](/docs/postman-flows/templates/mailchimp-setup/)
* [Set up Notion authorization for Postman Flows](/docs/postman-flows/templates/notion-setup/)
* [Set up Slack authorization for Postman Flows](/docs/postman-flows/templates/slack-setup/)
* [Set up Stripe authorization for Postman Flows](/docs/postman-flows/templates/stripe-setup/)