Unsplash · OAuth Scopes

Unsplash OAuth Scopes

OAuth 2.0 derived

Unsplash publishes 8 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Unsplash API on a user’s behalf.

Tokens are issued from https://unsplash.com/oauth/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

PhotosImagesPhotographyStock PhotosCreativeOpen SourceMedia
Scopes: 8 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://unsplash.com/oauth/authorize
Token URL
https://unsplash.com/oauth/token
Flows
authorizationCode

Scopes (8)

ScopeDescriptionFlows
public Read public data (default) authorizationCode
read_collections Read collection data authorizationCode
read_photos Read photo data authorizationCode
read_user Read user profile data authorizationCode
write_collections Create, update, delete collections authorizationCode
write_likes Like/unlike photos authorizationCode
write_photos Write photo data (update metadata) authorizationCode
write_user Write user profile data authorizationCode

Source

OAuth Scopes

unsplash-scopes.yml Raw ↑
generated: '2026-07-11'
method: derived
source: openapi/unsplash-openapi.yml
schemes:
- name: OAuth2
  source: openapi/unsplash-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://unsplash.com/oauth/authorize
    tokenUrl: https://unsplash.com/oauth/token
scopes:
- scope: public
  description: Read public data (default)
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: read_collections
  description: Read collection data
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: read_photos
  description: Read photo data
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: read_user
  description: Read user profile data
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: write_collections
  description: Create, update, delete collections
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: write_likes
  description: Like/unlike photos
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: write_photos
  description: Write photo data (update metadata)
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml
- scope: write_user
  description: Write user profile data
  flows:
  - authorizationCode
  sources:
  - openapi/unsplash-openapi.yml