# Beacon OAuth Rest Service

**Canonical:** https://apis.io/apis/beacon-roofing-supply/beacon-oauth/  
**Provider:** Beacon Roofing Supply — https://apis.io/providers/beacon-roofing-supply/  
**Base URL:** https://beaconproplus.com/rest/model/REST/oauth  
**Documentation:** https://beaconproplus.com/swagger/oauth2/

Beacon OAuth Rest Service is one of 7 APIs that [Beacon Roofing Supply](https://apis.io/providers/beacon-roofing-supply/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include OAuth, Authentication, Security, Construction, and Distribution. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

Beacon's OAuth 2.0 token service, implementing the refresh_token grant and linking to https://oauth.net/2/grant-types/refresh-token/ in its own description. Returns access_token, token_type, expires_in, refresh_expires_in, refresh_token and scope. The scopes request field is a refresh-behaviour selector (empty, "all" or "refresh_token"), not a permission scope. No initial grant is published — the first refresh_token is issued during partner onboarding. This is the only Beacon document that declares a servers[] block, and its default is the UAT host.

## Operations (1)

| Method | Path | Summary |
|---|---|---|
| POST | `/token` | Refresh access/refresh token |

## Machine-readable artifacts (4)

- **Documentation** — https://beaconproplus.com/swagger/oauth2/
- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/openapi/beacon-roofing-supply-oauth2-openapi.yml
- **OAuthScopes** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/scopes/beacon-roofing-supply-scopes.yml
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/beacon-roofing-supply/refs/heads/main/overlays/beacon-roofing-supply-oauth2-overlay.yaml

## Other Beacon Roofing Supply APIs (6)

- [Beacon PRO+ API (V2, OAuth)](https://apis.io/apis/beacon-roofing-supply/beacon-pro-plus/)
- [Beacon External Rest Service (all_api)](https://apis.io/apis/beacon-roofing-supply/beacon-rest-all-api/)
- [Beacon Rest Services V3 (Public / Integrations)](https://apis.io/apis/beacon-roofing-supply/beacon-rest-v3/)
- [Beacon Rest Services V1 (session)](https://apis.io/apis/beacon-roofing-supply/beacon-rest-v1/)
- [Beacon Rest Services Public](https://apis.io/apis/beacon-roofing-supply/beacon-rest-public/)
- [Beacon Internal Rest Service](https://apis.io/apis/beacon-roofing-supply/beacon-rest-internal/)

## Tags

OAuth, Authentication, Security, Construction, Distribution

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/beacon-roofing-supply/beacon-oauth/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/beacon-roofing-supply/.