Appbricx
Docs
FeaturesPricingStart free

Get started

OverviewWhat Appbricx isQuickstart with a coding agentQuickstart with the builderCore concepts

Guides

Data and tablesAccess and rolesBusiness rulesSign-inCustom screensRealtime and topicsWorkflows, schedules and webhooksServer functionsAI in your appPaymentsFilesMessagesIntegrationsVerifyPublishing, domains and rollbackOperating your appExport and self-hostSelf-host install

Tutorials

Build a booking app with Claude CodeMulti-user todo listClient portalSlack on new sign-upTemplates

Reference

Reference homeFrontend SDKHTTP APIMCP toolsCLIIntegrations catalogContract formatAI key resolutionRun Appbricx locally

Spotify

Search tracks, manage playlists, and browse your Spotify library.

Social mediaOAuth15 actionsAll integrations

On this page
  1. Connect
  2. Call it from a workflow
  3. Actions (15)
  4. add_playlist_items
  5. create_playlist
  6. get_playback_state
  7. get_playlist_info
  8. get_playlist_items
  9. get_playlists
  10. custom_api_call
  11. get_saved_tracks
  12. pause
  13. play
  14. remove_playlist_items
  15. reorder_playlist
  16. search
  17. set_volume
  18. update_playlist
  19. Details

Connect

Auth type: OAuth (oauth2). Click Connect and approve access on the provider's page. Appbricx runs the OAuth flow (signed single-use state, PKCE where the provider supports it), stores the tokens encrypted and refreshes them before they expire.

OAuth needs an OAuth app: the platform's when the operator configured one, or your own (admin panel, Integrations, Configure). You can also bring your own credentials.

  • In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
  • For every project in a workspace: Workspace settings, Integrations.
  • Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.

Call it from a workflow

Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.

Native workflow
// .workflow.js (native ctx)
export async function run(ctx) {
  const res = await ctx.integrations.invoke("spotify", "add_playlist_items", {
    "playlist_id": "<playlist_id>",
    "items": []
  });
  if (!res.success) throw new Error(res.error);
  ctx.log.info("Spotify answered", { output: res.output });
}
defineWorkflow module
// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";

export default defineWorkflow({
  id: "spotify-add-playlist-items",
  name: "Spotify: Add items to playlist",
  description: "Calls Spotify when a row is created.",
  trigger: { type: "entity_event", entity: "tickets", event: "created" },
  async run(ctx, event) {
    const res = await ctx.integrations.call("spotify", {
      "action": "add_playlist_items",
      "playlist_id": "<playlist_id>",
      "items": []
    }) as { success: boolean; error?: string };
    if (!res.success) throw new Error(res.error);
  },
});
From an app (connector proxy)
curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/spotify/add_playlist_items" \
  -H "Authorization: Bearer $APP_KEY" \
  -H "content-type: application/json" \
  -d '{"props":{"playlist_id":"<playlist_id>","items":[]}}'

Actions

add_playlist_itemsin catalog

Add items to playlist. Adds tracks or episodes to the playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist
itemsrequiredarrayURI's of the items to add
positionoptionalnumberPosition

create_playlistin catalog

Create Playlist. Creates a new playlist for the current user

InputTypeDescription
namerequiredtextName
descriptionoptionaltextDescription
publicoptionalbooleanPublic
collaborativeoptionalbooleanCollaborative

get_playback_statein catalog

Get Playback State. Retrieves the current playback state of the player

No input.

get_playlist_infoin catalog

Get Playlist Info. Retrieves details of a playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist

get_playlist_itemsin catalog

Get Playlist Items. Retrieves the list of items in the playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist
offsetoptionalnumberOffset
limitoptionalnumberLimit
alloptionalbooleanFetches all items in a single request

get_playlistsin catalog

Get Playlists. Retrieves the list of playlists that you created or followed

InputTypeDescription
offsetoptionalnumberOffset
limitoptionalnumberLimit
alloptionalbooleanFetches all playlists in a single request

custom_api_call

Custom API Call. Make a custom API call to a specific endpoint

InputTypeDescription
urlrequiredobject (depends on other props)url
methodrequiredone of "GET" | "POST" | "PATCH" | "PUT" | "DELETE" | "HEAD"Method
headersrequiredobjectAuthorization headers are injected automatically from your connection.
queryParamsrequiredobjectQuery Parameters
body_typeoptionalone of "none" | "json" | "form_data" | "raw"Body Type
bodyoptionalobject (depends on other props)Body
response_is_binaryoptionalbooleanEnable for files like PDFs, images, etc.
failsafeoptionalbooleanNo Error on Failure
timeoutoptionalnumberTimeout (in seconds)
followRedirectsoptionalbooleanFollow redirects

get_saved_tracks

Get Saved Tracks. Retrieves the list of saved tracks for the current user

InputTypeDescription
offsetoptionalnumberOffset
limitoptionalnumberLimit
alloptionalbooleanFetches all items in a single request

pause

Pause. Pauses the playback

InputTypeDescription
device_idoptionalid (picked from your account)Device

play

Play / Resume. Resumes or starts playback

InputTypeDescription
device_idoptionalid (picked from your account)Device
context_urioptionaltextSpotify URI of the context to play (album, artist, playlist)
tracksoptionalarrayList of spotify track uris to play
position_msoptionalnumberPosition in milliseconds

remove_playlist_items

Remove items from playlist. Removes tracks or episodes from the playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist
itemsrequiredarrayURI's of the items to remove

reorder_playlist

Reorder playlist. Reorders items in the playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist
from_positionrequirednumberFrom Position
to_positionrequirednumberTo Position
amountoptionalnumberAmount of Items

search

Search. Searches for tracks, artists, albums, etc.

InputTypeDescription
search_textrequiredtextThe word or phrase you are searching for
typesrequiredlist ofObject Types
limitoptionalnumberLimit
offsetoptionalnumberOffset

set_volume

Set Volume. Sets the volume of the player

InputTypeDescription
volumerequirednumberVolume from 0 to 100
device_idoptionalid (picked from your account)Device

update_playlist

Update Playlist. Updates details of the playlist

InputTypeDescription
playlist_idrequiredid (picked from your account)Playlist
nameoptionaltextName
descriptionoptionaltextDescription
publicoptionalbooleanPublic
collaborativeoptionalbooleanCollaborative

Details

Id
spotify
Category
Social media
Tags
music, audio, playlists, streaming
Package
@activepieces/piece-spotify@0.4.4
Tier
Community

On this page

  1. Connect
  2. Call it from a workflow
  3. Actions (15)
  4. add_playlist_items
  5. create_playlist
  6. get_playback_state
  7. get_playlist_info
  8. get_playlist_items
  9. get_playlists
  10. custom_api_call
  11. get_saved_tracks
  12. pause
  13. play
  14. remove_playlist_items
  15. reorder_playlist
  16. search
  17. set_volume
  18. update_playlist
  19. Details
Appbricx

The backend, runtime and hosting for apps your coding agent builds. On our cloud, in yours, or on your own servers.

Features

Coding agents and MCPVerify testingBuilder consolePostgres databaseData APIRealtimeRow-level securitySign-in and authPaymentsWorkflows and jobsAI in your appIntegrationsBackups and rollbackHosting and domainsSelf-host and exportAll features

Product

ShowcasePricingFor coding agentsTemplatesPrivate cloudBring your own AI keyFAQ

Compare

Appbricx vs SupabaseLovable alternativeBolt alternativeFor freelancersFor agencies

Resources

DocumentationReferenceBlogSupportContact

© 2026 Appbricx. All rights reserved.

TermsPrivacyCookiesAcceptable Use