Upwork icon

Upwork

Automate Upwork with OAuth2, API tokens, GraphQL, REST, and AI-friendly outputs

Actions11

Contract → Get Many Contracts

AI-generated

Summary

Fetches a page of Upwork contracts through the GraphQL API. Returns each contract as a separate n8n item, including its ID, title, status, start and end dates, client, and freelancer by default.

Inputs

  • Authentication (required) — Choose OAuth2 or API Token credentials.
  • Limit — Number of contracts to request; defaults to 25 (UI range 1–100).
  • Cursor — Optional GraphQL pagination cursor for requesting a page.
  • Advanced: GraphQL Query Override — Replace the built-in contracts query.
  • Advanced: Variables — JSON object merged into the generated GraphQL variables, which include first (limit) and after (cursor).
  • Advanced: Item Path — Dot path to the result. Defaults to contracts; connection nodes or edges are unwrapped automatically.

Output shape

A list of n8n items, one per extracted contract.

Each item has json fields id, resource, operation, data, and _meta. The contract fields are under data. This fetches one page per execution; use the returned pageInfo in a custom query if you need its pagination details, since the default item extraction returns only contract nodes.

Links

Discussion