View as Markdown
Salesforce icon

Salesforce ACTION

List Cases

List Salesforce support cases, newest first. Use this to find a case and its ID. Every filter is optional and they combine with AND - call with no filters to see the most recent cases. For example, Status New with Limit 10 returns the ten newest open cases. Status values are org-configurable. See the documentation
  • Action
  • Read only
  • OAuth
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Salesforce account once, then configure and run List Cases from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "salesforce_rest_api-list-cases",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    salesforce_rest_api: { authProvisionId: "apn_xxxxxxx" },
    caseNumber: "Case Number",
    subject: "Subject Contains",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

List Cases inputs
Property Type Description
caseNumber Case Number string
Return only the case with this case number, e.g. 00001024. This is the human-readable number shown in the Salesforce UI, not the record ID.
Optional
subject Subject Contains string
Return only cases whose subject contains this text (case-insensitive), e.g. rotor.
Optional
status Status string
Return only cases with this exact status, e.g. New. Org-configurable - use Describe Object on Case to list the valid values.
Optional
accountId Account ID string
Return only cases on this account (15- or 18-character Salesforce ID, e.g. 001P500000dGpZLIA0). Use Find Records on Account to look one up.
Optional
isClosed Is Closed boolean
Set to true to return only closed cases, or false for only open ones. Omit to return both.
Optional
createdAfter Created After string
Return only cases created on or after this moment. ISO 8601 date (2026-08-01) or date-time (2026-08-01T00:00:00Z).
Optional
fields Fields string[]
The Case fields to return. Defaults to a compact set: Id, CaseNumber, Subject, Status, Priority, Origin, IsClosed, AccountId, ContactId, OwnerId, CreatedDate, LastModifiedDate. Id is always returned.
Optional Dynamic
limit Limit integer
The maximum number of cases to return. Valid values are integers from 1 through 1000. Default is 100.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
salesforce_rest_api-list-cases
Version
0.0.4
App
Salesforce
Authentication
OAuth
Read-only
Yes
Destructive
No
Open world
Yes