View as Markdown
Quo icon

Quo ACTION

List Contacts

Retrieve a paginated list of contacts. Optionally filter by external IDs and/or sources. All contacts for the organization are returned only when neither externalIds nor sources is provided. Example: call with no filters → returns up to 10 contacts for the organization. Use fields to return only specific fields per contact. See the documentation
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Quo account once, then configure and run List Contacts 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: "openphone-list-contacts",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    openphone: { authProvisionId: "apn_xxxxxxx" },
    externalIds: ["External IDs"],
    sources: ["Sources"],
  },
})

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 Contacts inputs
Property Type Description
externalIds External IDs string[]
Optional list of unique identifiers from an external system used to retrieve specific contacts. These must match the externalId values supplied when the contacts were created via Create a Contact. When omitted, all contacts for the organization are returned.
Optional
sources Sources string[]
Optional list of sources to filter by, indicating how the contact was created or where it originated from.
Optional
maxResults Max Results integer
Maximum number of contacts to return per page. Min 1, max 50. Defaults to 10.
Optional
pageToken Page Token string
Pagination token (nextPageToken from a previous response) to fetch the next page of results. If nextPageToken is present in a response, call this action again with pageToken set to that value to fetch more results.
Optional
fields Fields string[]
Optional list of fields to include in each returned record (e.g. ["id", "createdAt"]). When omitted, the full record is returned.
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
openphone-list-contacts
Version
0.0.2
App
Quo
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes