Skip to main content

Sponsors

Reference documentation for GraphQL schema types in the Sponsors category.

In this article

Queries

sponsorables

Query

Users and organizations who can be sponsored via GitHub Sponsors.

Type: SponsorableItemConnection!

Arguments for sponsorables

NameDescription

after (String)

Returns the elements in the list that come after the specified cursor.

before (String)

Returns the elements in the list that come before the specified cursor.

dependencyEcosystem (SecurityAdvisoryEcosystem)

Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true.

Upcoming Change on 2022-07-01 UTC Description: dependencyEcosystem will be removed. Use the ecosystem argument instead. Reason: The type is switching from SecurityAdvisoryEcosystem to DependencyGraphEcosystem.

ecosystem (DependencyGraphEcosystem)

Optional filter for which dependencies should be checked for sponsorable owners. Only sponsorable owners of dependencies in this ecosystem will be included. Used when onlyDependencies = true.

first (Int)

Returns the first n elements from the list.

last (Int)

Returns the last n elements from the list.

onlyDependencies (Boolean)

Whether only sponsorables who own the viewer's dependencies will be returned. Must be authenticated to use. Can check an organization instead for their dependencies owned by sponsorables by passing orgLoginForDependencies.

The default value is false.

orderBy (SponsorableOrder)

Ordering options for users and organizations returned from the connection.

orgLoginForDependencies (String)

Optional organization username for whose dependencies should be checked. Used when onlyDependencies = true. Omit to check your own dependencies. If you are not an administrator of the organization, only dependencies from its public repositories will be considered.

Mutations

cancelSponsorship

Mutation

Cancel an active sponsorship.

Input fields for cancelSponsorship

Return fields for cancelSponsorship

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsTier (SponsorsTier)

The tier that was being used at the time of cancellation.

createSponsorship

Mutation

Start a new sponsorship of a maintainer in GitHub Sponsors, or reactivate a past sponsorship.

Input fields for createSponsorship

Return fields for createSponsorship

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorship (Sponsorship)

The sponsorship that was started.

createSponsorships

Mutation

Make many sponsorships for different sponsorable users or organizations at once. Can only sponsor those who have a public GitHub Sponsors profile.

Input fields for createSponsorships

Return fields for createSponsorships

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorables ([Sponsorable!])

The users and organizations who received a sponsorship.

createSponsorsListing

Mutation

Create a GitHub Sponsors profile to allow others to sponsor you or your organization.

Input fields for createSponsorsListing

Return fields for createSponsorsListing

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsListing (SponsorsListing)

The new GitHub Sponsors profile.

createSponsorsTier

Mutation

Create a new payment tier for your GitHub Sponsors profile.

Input fields for createSponsorsTier

Return fields for createSponsorsTier

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsTier (SponsorsTier)

The new tier.

publishSponsorsTier

Mutation

Publish an existing sponsorship tier that is currently still a draft to a GitHub Sponsors profile.

Input fields for publishSponsorsTier

Return fields for publishSponsorsTier

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsTier (SponsorsTier)

The tier that was published.

retireSponsorsTier

Mutation

Retire a published payment tier from your GitHub Sponsors profile so it cannot be used to start new sponsorships.

Input fields for retireSponsorsTier

Return fields for retireSponsorsTier

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsTier (SponsorsTier)

The tier that was retired.

updatePatreonSponsorability

Mutation

Toggle the setting for your GitHub Sponsors profile that allows other GitHub accounts to sponsor you on GitHub while paying for the sponsorship on Patreon. Only applicable when you have a GitHub Sponsors profile and have connected your GitHub account with Patreon.

Input fields for updatePatreonSponsorability

Return fields for updatePatreonSponsorability

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorsListing (SponsorsListing)

The GitHub Sponsors profile.

updateSponsorshipPreferences

Mutation

Change visibility of your sponsorship and opt in or out of email updates from the maintainer.

Input fields for updateSponsorshipPreferences

Return fields for updateSponsorshipPreferences

NameDescription

clientMutationId (String)

A unique identifier for the client performing the mutation.

sponsorship (Sponsorship)

The sponsorship that was updated.

Objects

SponsorableItemConnection

Object

The connection type for SponsorableItem.

Fields for SponsorableItemConnection

NameDescription

edges ([SponsorableItemEdge])

A list of edges.

nodes ([SponsorableItem])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

SponsorableItemEdge

Object

An edge in a connection.

Fields for SponsorableItemEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (SponsorableItem)

The item at the end of the edge.

SponsorAndLifetimeValue

Object

A GitHub account and the total amount in USD they've paid for sponsorships to a particular maintainer. Does not include payments made via Patreon.

Fields for SponsorAndLifetimeValue

NameDescription

amountInCents (Int!)

The amount in cents.

formattedAmount (String!)

The amount in USD, formatted as a string.

sponsor (Sponsorable!)

The sponsor's GitHub account.

sponsorable (Sponsorable!)

The maintainer's GitHub account.

SponsorAndLifetimeValueConnection

Object

The connection type for SponsorAndLifetimeValue.

Fields for SponsorAndLifetimeValueConnection

NameDescription

edges ([SponsorAndLifetimeValueEdge])

A list of edges.

nodes ([SponsorAndLifetimeValue])

A list of nodes.

pageInfo (PageInfo!)

Information to aid in pagination.

totalCount (Int!)

Identifies the total count of items in the connection.

SponsorAndLifetimeValueEdge

Object

An edge in a connection.

Fields for SponsorAndLifetimeValueEdge

NameDescription

cursor (String!)

A cursor for use in pagination.

node (SponsorAndLifetimeValue)

The item at the end of the edge.

SponsorConnection