Get Album

spotify.get_album

ActionBusiness appsconnection required

Calls the Spotify API with the connection's credentials.

Read one album's catalogue metadata and its first page of tracks.

Ask about Spotify All Spotify nodes Provider API docs ↗

Connection

Required: Yes — the node will not save without one
Auth type: OAuth 2.0
Providers: Spotify
Secret shape: {"client_id": "…", "client_secret": "…", "refresh_token": "…"}
Config it needs: market, device_id
Resolved by: config.connection_id, else node.connection_id

Configuration

2 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.

Field	Type	Required	Default	Constraints	Example
album_id The Spotify id of the album, as it appears in a search result or on a track's album object.	string	Yes	—	—	4aawyAB9vmqN3uQ7FjRGTy
market ISO 3166-1 alpha-2 country code deciding which catalogue is visible, such as 'US'. Left blank, the connection's default market is used, and the market on the authorised account takes priority over both.	string	No	—	—	US

Example configuration

Every value below is the contract’s own example or default — nothing invented.

{
  "album_id": "4aawyAB9vmqN3uQ7FjRGTy",
  "market": "US"
}

Output

One shape.

result

Field	Type	Example
id The album's Spotify id.	string	—
uri The album's Spotify URI, usable as a playback context.	string	—
name The album title.	string	—
album_type Whether this is an album, single or compilation.	string	—
release_date Release date, to the precision Spotify holds.	string	—
total_tracks How many tracks the album has.	number	—
label The label that released it.	string	—
artists[].name Name of each credited album artist.	string	—
tracks.items The album's tracks, first page only.	array	—
external_urls.spotify Open the album in a Spotify client.	string	—

{
  "album_type": "",
  "artists": [
    {
      "name": ""
    }
  ],
  "external_urls": {
    "spotify": ""
  },
  "id": "",
  "label": "",
  "name": "",
  "release_date": "",
  "total_tracks": 0,
  "tracks": {
    "items": []
  },
  "uri": ""
}

Related Spotify nodes

See Get Album run in a workflow.

In a technical demo we add the Spotify connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.

Book a technical demo Talk to sales