REST OAuth2
Budibase supports OAuth2 in REST connections using Client Credentials.
This is intended for machine-to-machine API access.
Required OAuth2 fields
| Field | Purpose |
|---|---|
| Name | Label used in auth selection |
| Authentication method | How client credentials are sent |
| Grant type | Must be Client Credentials |
| Service URL | Provider token endpoint |
| Client ID | OAuth application client ID |
| Client Secret | OAuth application secret |
| Scope | Optional/required provider scopes |
Configure OAuth2 in a connection
- Open Settings > Connections > APIs
- Open/create a connection
- Go to Authentication
- Click Add authentication
- Choose OAuth2 type
- Enter required fields
- Save
Use OAuth2 in queries
- Click Open in API Editor
- Open/create query
- Select OAuth2 config in query auth settings
- Click Send
- Save query
Example (Spotify)
- Service URL:
https://accounts.spotify.com/api/token - Grant type:
Client Credentials
Use your provider-issued client ID and client secret.
Troubleshooting matrix
| Error | Typical cause | Action |
|---|---|---|
invalid_client | Bad client ID/secret | Re-copy credentials from provider |
unsupported_grant_type | Wrong grant configured | Set Client Credentials |
invalid_scope | Scope format/value invalid | Match provider scope syntax |
| API call still unauthorized | Wrong auth config selected in query | Re-select auth config and resend |
Related guides
Updated about 1 month ago
What’s Next