GrowthHub API 2.0

Authorization

Authorization is the process of granting or restricting access to resources based on a user’s verified identity and assigned permissions. It defines what actions a user is allowed to perform within a system after authentication (identity verification) has been completed. In simple terms, it ensures users can only access what they’re permitted to use or modify.

GrowthHub currently supports two types of authorization:

When should I use a Private Integration Token?

You should use a Private Integration Token if:

  • Your use case involves accessing our API endpoints for internal operations.

  • If you don’t require webhooks, custom UI design, or custom pages.

  • If you only need access to a single sub-account at a time.

Example use cases:

  • Internal data synchronization

  • Custom reporting dashboards

  • Automated workflows within your internal system

When should I use OAuth 2.0 Flow?

You should use OAuth 2.0 Flow if:

  • You’re building a full-scale integration designed for public use.

  • Your integration requires features such as webhooks and custom modules.

  • You need enhanced security and standardized authorization handling.

Example use cases:

  • Third-party applications

  • Building custom conversation providers, workflow actions, triggers, etc.

  • Services that require secure user authorization