Archive API docs
    Jump to

    Narrow by kind with a prefix — q: queries, m: mutations, t: types, g: guides, f: fields and arguments.

    Jump to examples ↓
    Query

    creators

    List and paginate creators for the current workspace, ordered newest first unless sorting or a presetId view says otherwise.

    Arguments

    Object, input and enum types open in place — use + to reveal their fields. A type that is already open above the row stops at a ↻ circular marker, and anything nested past the depth limit links out to its own page instead.

    after String default null
    Cursor for fetching the next page of results.
    applyViewFilters Boolean default false
    When true and presetId is a workspace Creator View, also narrow by the view's stored filters blob, the way the app's Creators page does: linked handles (accountNames) and canonical locations (locationsCanonical, including region groups such as {group: "dach"}). Other stored keys and unreadable values are ignored. Campaign Creator Views and calls without presetId are unaffected. Defaults to false.
    customAttributeConditions [CustomAttributeConditionInput!] default []
    Creator custom attributes conditions
    filter CreatorFilterInput default {}
    Filter criteria to narrow down results (e.g. by campaign roster, handle or canonical location).
    first Int default 20
    Number of creators to return (page size).
    presetId ID default null
    Saved Creator View ID. When provided, inline filter and customAttributeConditions are ignored; the view's stored conditions and sortBy drive the result set. A workspace Creator View's stored filters blob is applied only with applyViewFilters: true; otherwise a view whose only narrowing lives in filters returns the whole workspace. Accepts IDs returned by creatorViews / creatorView (workspace Creator Views, generally available), or by campaignCreatorViews(campaignId:) / campaignCreatorView(id:) (campaign-scoped, in alpha; opt in with the campaign_creator_views header). A campaign Creator View returns only the creators on its campaign. Non-Creator-View IDs raise a GraphQL error with extensions.code = "WRONG_VIEW_TYPE"; cross-workspace or unknown IDs raise with extensions.code = "NOT_FOUND".
    sorting [CreatorSortingInput!] default null
    Sort configuration: a list of at most one entry (compound sort is not supported). When given it wins over the stored sort of a presetId view; when omitted the view's stored sort applies, or newest first ([{ sortKey: CREATED_AT, sortOrder: DESC }]) without a view. Ties are broken by creator ID, ascending. Keep the same sorting while following endCursor.

    Returns

    A paginated connection of Creator nodes. See Pagination for the connection shape.

    edges [CreatorEdge!]!
    List of edges with cursors.
    nodes [Creator!]!
    List of creators.
    pageInfo PageInfo!
    Pagination information.
    totalCount Int
    Total number of items available.