--- title: API Users - What they are and how to use them description: An API User is a special account created for your group that is able to access the API as a regular User would. They have much more visibility and flexibility to build on top of our API. --- [Skip to content](https://pool-faq.foundrydigital.com/api-users#main-content) English Show submenu for translations ![Foundry-USA-Pool-inverse (1).png\]](https://pool-faq.foundrydigital.com/hs-fs/hubfs/Foundry-USA-Pool-inverse%20(1).png?height=40&name=Foundry-USA-Pool-inverse%20(1).png) - [Foundry Home](https://foundrydigital.com/) Open main navigation Close main navigation - [Foundry Home](https://foundrydigital.com/) - English Show submenu for translations Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Foundry USA Pool Knowledge Base](https://pool-faq.foundrydigital.com/?hsLang=en) 2. [API](https://pool-faq.foundrydigital.com/api?hsLang=en) # API Users - What they are and how to use them ### What is an API User? An API User is a special account created for your group that is able to access the API as a regular User would. They have much more visibility and flexibility to build on top of our API. ### Prerequisites to create an API User In order to create an API User, the Foundry Pool team will need the following: 1. **A Request**: An email requesting a new API user should be sent to [*support@foundryusapool.com*](mailto:support@foundryusapool.com) with the following information: 1. An **email address** that is not already in use. If you wish to reuse an email that is already in taken, *plus addressing*  is a valid alternative ([Plus Addressing in Exchange Online](https://learn.microsoft.com/en-us/exchange/recipients-in-exchange-online/plus-addressing-in-exchange-online)). *For example, If* [*john.doe@example.com*](mailto:john.doe@example.com) *is in use, you can use* [*john.doe+api@example.com*](mailto:john.doe+api@example.com) *instead*. 2. **Full name** and **Preferred name**. These can be the same value. 3. The API User **role** in the pool: Owner, Technician or Accountant. 4. List of IP’s to whitelist: **Only mandatory if the role of the API User is owner.** 5. **Company name** under which the API User will be created. 2. **Group owner’s written approval**: This is unrelated to the approval-request flow inside Foundry Pool. You need to provide explicit written consent from an owner of the group. ### API User: First Steps After receiving the confirmation that the API User has been created, it will be ready for activation. #### ![:white\_check\_mark:](https://foundrydigitalllc.atlassian.net/gateway/api/emoji/d81a8704-03c7-4022-b055-5896edda14ac/2705/path) Activation of an API User Upon creation, the API User will receive a new email from *support@foundryusapool.com*  to its address with the subject **Verify your email** requesting to confirm the user account. Click on **Confirm my account**. ![](blob:https://foundrydigitalllc.atlassian.net/58f5c9ce-d42d-44f6-b2bb-599322064387#media-blob-url=true&id=76275b8d-4ba8-4e17-8aa4-77e746d134a9&collection=contentId-1418788871&contextId=1418788871&height=455&width=1100&alt=) #### ![:key:](https://foundrydigitalllc.atlassian.net/gateway/api/emoji/d81a8704-03c7-4022-b055-5896edda14ac/1f511/path) Set up a Password for the API User API Users need a password to be able to obtain an Access Token that will be used to interact with the endpoints of Foundry Pool’s REST API. In order to create a password for an API User the following is needed to: 1. Navigate to [Foundry USA Pool](https://foundryusapool.com/login) 2. Enter the email address used for the API User 3. Click on **Forgot password?** 4. Enter the API User email in the email field and click **Continue** 5. The API User email will receive a new email from *support@foundryusapool.com* with the subject **Reset your password.** Follow the directions in the email to set the password for the account. 6. Login with the email and new password. ### How to use an API User API Users can interact with the Pool’s REST API endpoints by simply passing an Access Token as the value for the Authorization header. ⚠️ In order to **get an Access Token for an API User**, send a GET HTTP Request to the endpoint *https://api.pool.foundrydigital.com/access\_token* and pass the API User email and password as values of the Email-Address and Password headers respectively. ![:blue\_book:](https://foundrydigitalllc.atlassian.net/gateway/api/emoji/d81a8704-03c7-4022-b055-5896edda14ac/1f4d8/path) [See the Access Token endpoint documentation](https://api.foundryusapool.com/#api-Access_Token-GetAccess_token) - [Getting started](https://pool-faq.foundrydigital.com/getting-started?hsLang=en) - [Alerts](https://pool-faq.foundrydigital.com/alerts?hsLang=en) - [API](https://pool-faq.foundrydigital.com/api?hsLang=en) - [Controls and Security](https://pool-faq.foundrydigital.com/controls-and-security?hsLang=en) - [Feedback](https://pool-faq.foundrydigital.com/feedback?hsLang=en) - [Hashrate](https://pool-faq.foundrydigital.com/hashrate?hsLang=en) - [Mining](https://pool-faq.foundrydigital.com/mining?hsLang=en) - [Payouts](https://pool-faq.foundrydigital.com/payouts?hsLang=en#main-content) - [FPPS Calculations](https://pool-faq.foundrydigital.com/payouts?hsLang=en#fpps-calculations) - [Pool Fees](https://pool-faq.foundrydigital.com/payouts?hsLang=en#pool-fees) - [Statistics](https://pool-faq.foundrydigital.com/statistics?hsLang=en#main-content) - [Shares](https://pool-faq.foundrydigital.com/statistics?hsLang=en#shares) - [Stratum](https://pool-faq.foundrydigital.com/stratum?hsLang=en#main-content) - [Proxy](https://pool-faq.foundrydigital.com/stratum?hsLang=en#proxy) - [Sub-accounts](https://pool-faq.foundrydigital.com/sub-accounts?hsLang=en) - [Users](https://pool-faq.foundrydigital.com/users?hsLang=en) - [Workers](https://pool-faq.foundrydigital.com/workers?hsLang=en) - [Foundry USA Pool Onboarding](https://pool-faq.foundrydigital.com/foundry-usa-pool-onboarding?hsLang=en) - [FAQs](https://pool-faq.foundrydigital.com/faqs?hsLang=en) - [Reports](https://pool-faq.foundrydigital.com/reports?hsLang=en) - [Foundry Home](https://foundrydigital.com/) [![Chill listening crop-3](https://pool-faq.foundrydigital.com/hs-fs/hubfs/Foundry-USA-Pool.png?width=52&height=24&name=Foundry-USA-Pool.png "Chill listening crop-3")](http://foundrydigital.com) foundrydigital.com Help Center Copyright © 2026, Foundry Digital LLC