> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions/get-teams.md).

# Get Teams

Read HubSpot team identifiers and names for use in workflow decisions.

**Action identifier:** `get_teams`. **Reference checked:** 29 September 2026.

## Inputs

No action inputs. Select the HubSpot connection.

## Output shape

Paths are relative to this action's output. Select them from the builder's variable picker; do not add a `ticket` wrapper to actions that return top-level fields. Nullable property fields and empty defaults are not proof that a value was retrieved.

| Path                  | Type            | Meaning                                                            |
| --------------------- | --------------- | ------------------------------------------------------------------ |
| `results`             | list of objects | Team records returned by HubSpot.                                  |
| `results[].id`        | string          | HubSpot team ID.                                                   |
| `results[].name`      | string          | Team display name.                                                 |
| `exists`              | boolean         | True when at least one team is returned.                           |
| `llm_triage_metadata` | string          | Text summary of team names and IDs; `No entries found` when empty. |

Open property/record objects may include additional HubSpot fields. Inspect the returned data rather than assuming every declared field is populated.

## Behavior and limits

Requires `settings.users.teams.read`. Returns team records for inspection and routing decisions; it does not assign a ticket to a team by itself.

No returned teams gives an empty list, `exists: false` and `No entries found`. Missing scope fails the request rather than being an empty portal.

See [Troubleshooting](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/troubleshooting.md) for request errors and retry behavior, or return to the [action catalog](/ebbot-docs/integrations/automations-integrations/integration-setup-guides/hubspot-integration-in-automations/actions.md).
