Upwork icon

Upwork

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

Actions11

Message → Get Rooms

AI-generated

Summary

Fetches Upwork message rooms using GraphQL, returning each room with its ID, title, update time, and unread count. Choose OAuth2 or API Token authentication; optionally set the page size and cursor to control the request.

Inputs

  • authentication (required) — Select OAuth2 (default) or API Token credentials.
  • limit — Number of rooms to request; defaults to 25, with a declared range of 1–100.
  • cursor — Optional GraphQL pagination cursor.
  • Advanced: GraphQL Query Override — Replace the built-in room query. The default query requests each room's id, title, updatedAt, unreadCount, and pagination pageInfo.
  • Advanced: Variables — JSON object merged into the generated GraphQL variables, which include the page size and cursor.
  • Advanced: Item Path — Dot path to the result items; defaults to messageRooms. Arrays and GraphQL connections with nodes or edges are unwrapped automatically.

Output shape

A list of n8n items, one per returned room. Each item contains id, resource, operation, data, and _meta fields.

data holds the room fields returned by the query; _meta includes source, fetch time, and transport. Pagination metadata is not included in the emitted items by default. If continue-on-fail is enabled, failures produce an item with error and itemIndex instead.

Links

Discussion