> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Connect Hugging Face with User Access Token – StackOne Hub
> Link a Hugging Face account in the StackOne Hub using User Access Token. End-user guide to authorize the integration and start using Hugging Face actions.
Create a User Access Token
Hugging Face authenticates API calls with a User Access Token generated from your account settings.
On the Access Tokens page, under User Access Tokens, click + Create new token.
On Create new Access Token, pick a Token type and fill in Token name. Hugging Face warns that This cannot be changed after token creation.
- Fine-grained — recommended. Tick only the permissions you need and scope them to selected repositories or organizations.
- Read — read access to every public and private repository you can already read.
- Write — read plus write access to every repository you can write to.
Under Presets, choose the closest starting point, then click Customize permissions to adjust it. Create token stays disabled until a preset is chosen.
- Read-Only — Download models and datasets.
- Inference, Write, CI/CD, Full Access and Custom are the other presets.
- Under Applies to:, your own namespace is included; use Add an organization to extend the token to an organization.
Click Create token. Hugging Face shows Save your Access Token with the value and a Copy button. Copy it, then paste it into the User Access Token field in StackOne Hub.
- The token value is only displayed once and cannot be retrieved later — close the modal with Done only after you have copied it.
- The value starts with `hf_`.
Permissions to select on a fine-grained token
Choosing the Custom preset opens the full permission list. Tick the entries matching the actions you plan to run.
Under User permissions, the groups below carry the permissions the connector's actions use.
- Read contents of your repos — required for every model, dataset and Space read action.
- Write contents/settings of your repos — required for commits, branches, tags and repository settings.
- Read contents of public gated repos you can access and View access requests for your gated repos — required for the gated-repository actions.
- Interact with discussions / Open PRs on your repos and Interact with discussions / Open PRs on external repos — required for the discussion and pull request actions.
- Read your collections and Write to your collections — required for the collection actions.
- Read billing usage and payment method status — required for the usage and billing actions.
- Read org settings — required for the organization member actions.
- Use Repositories permissions below the user permissions to override these for individually selected repositories.
Organizations with token policies
Organizations on the Team and Enterprise plans can restrict which tokens reach their resources.
- A fine-grained token scoped to such an organization starts as Pending until an administrator approves it, and returns `403` against that organization's resources until then.
- Some organizations reject read and write tokens outright and accept only fine-grained tokens.
Linking the Account from the Hub
Use one of the three Linking Account Methods to access the Hub.
Fill out the following fields using details from your provider:
- Click Connect
- If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.
- Once authorization is successful, you will see a confirmation popup
If the account linking is successful, you will see the newly linked account in your Accounts page.
