Input objects
ActivityCreateInput
A task to create on a supporter or a donation.
Arguments
| Name | Description |
|---|---|
subjectActivitySubject! | Kind of record the task is attached to. |
subjectIdInt! | Identifier of the record the task is attached to. |
categoryActivityCategory! | Kind of task to carry out. |
deadlineDateDate | Day the task is due. |
doneDateDate | Day the task was carried out, to record a task already done. |
noteString | Free-text note describing the task. |
staffIdInt | Staff member the task is assigned to. Defaults to the caller when omitted. |
ActivityFilters
Search filters for activities. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the note of the activity. |
orderString | Field to sort by, prefixed with |
dueDateDateRange | Keep only tasks due in this range. |
userIdInt | Keep only the tasks assigned to this staff member. |
supporterIdInt | Keep only the tasks attached to this supporter. |
donationIdInt | Keep only the tasks attached to this donation. |
ActivityUpdateInput
Fields of a task that can be changed. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
categoryActivityCategory | Kind of task to carry out. |
deadlineDateDate | Day the task is due. |
doneDateDate | Day the task was carried out. |
noteString | Free-text note describing the task or its outcome. |
staffIdInt | Staff member the task is assigned to. |
ArticleInput
Fields of a blog post that can be written. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
titleString | Title of the post. |
contentString | Body of the post, as HTML. |
visibilityWebDocumentVisibility | Whether the post is public, reachable only by direct link, or hidden. |
slugString | URL segment of the post. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the post. |
coverIdInt | Media used as cover image of the post. |
blogIdInt | Blog the post belongs to. |
ArticlesFiltersInput
Search filters for blog posts.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title and the content of the post. |
BlogInput
Fields of a blog that can be written. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
titleString | Title of the blog. |
contentString | Introduction shown on the blog page, as HTML. |
visibilityWebDocumentVisibility | Whether the blog is public, reachable only by direct link, or hidden. |
slugString | URL segment of the blog. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the blog. |
coverIdInt | Media used as cover image of the blog. |
BlogsFiltersInput
Search filters for blogs.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title and the content of the blog. |
CampaignCommentCreateInput
A comment to attach to a donation. The campaign and the author are taken from the donation.
Arguments
| Name | Description |
|---|---|
donationIdInt! | Donation the comment belongs to. |
messageString! | Text of the comment. |
statusCampaignCommentStatus! | Moderation state to create the comment with. Approved by default. |
publicBoolean! | Whether the comment may be shown publicly. |
anonymousBoolean! | Whether the comment must be shown without the name of the donor. |
CampaignCommentsFilters
Search filters for the comments left on campaigns. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the text of the comment. |
supporterIdInt | Keep only the comments of this supporter. |
campaignIdInt | Keep only the comments left on this campaign. |
donationIdInt | Keep only the comment attached to this donation. |
statusCampaignCommentStatus | Keep only comments in this moderation state. |
CampaignCommentUpdateInput
Fields of a comment that can be changed while moderating it. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
messageString | Text of the comment. |
statusCampaignCommentStatus | New moderation state of the comment. |
publicBoolean | Whether the comment may be shown publicly. |
anonymousBoolean | Whether the comment must be shown without the name of the donor. |
CampaignFilters
Search filters for campaigns. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title and the content of the campaign. |
orderString | Field to sort by, prefixed with |
tags[String!] | Keep only campaigns carrying at least one of these labels. |
tagsNot[String!] | Drop the campaigns carrying all of these labels. |
channels[String!] | Keep only campaigns offered on these applications (channels). |
ids[Int!] | Restrict the results to these campaigns. |
visibilityWebDocumentVisibility | Keep only campaigns with this visibility on the public site. |
CampaignInput
Fields of a campaign that can be written, including its public page and the configuration of its donation form. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
titleString | Title of the campaign page. |
contentString | Body of the campaign page, as HTML. |
visibilityWebDocumentVisibility | Whether the page is public, reachable only by direct link, or hidden. |
slugString | URL segment of the page. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the campaign page. |
thankyouTemplateString | Name of the theme template rendering the thank-you page. |
receiptNotificationIdInt | Notification used to send the receipt for donations to this campaign. |
coverIdInt | Media used as cover image of the campaign page. |
isGoalEnabledBoolean | Whether the goal and its progress bar are shown on the public page. |
codeString | Human-readable identifier of the campaign, used in reporting. |
goalFloat | Amount the campaign aims to raise. |
typeCampaignType | Kind of campaign, which decides how it is presented and collected. |
tags[String!] | Full replacement of the labels attached to the campaign. |
excludedChannels[Int!] | Identifiers of the applications (channels) the campaign must not be offered on. |
excludedPaymentMethods[Int!] | Identifiers of the payment methods that must not be offered on this campaign. |
allowPeerToPeerBoolean | Whether supporters may open their own peer-to-peer page for this campaign. |
costExamples[CostExampleInput!] | Full replacement of the cost examples offered by the campaign. |
hasOneOffBoolean | Whether the form offers one-off donations. |
hasSubscriptionBoolean | Whether the form offers recurring donations. |
hasSubscriptionCustomOptionsBoolean | Whether recurring donations use their own amounts and limits instead of reusing the one-off ones. |
defaultAmountFloat | One-off amount preselected on the form. |
minAmountFloat | Smallest one-off amount accepted. |
maxAmountFloat | Largest one-off amount accepted. |
asks[Float!] | Suggested one-off amounts, shown as buttons on the form. |
allowCustomAmountBoolean | Whether the donor may type a one-off amount of their choice. |
defaultSubscriptionAmountFloat | Recurring amount preselected on the form. |
minSubscriptionAmountFloat | Smallest recurring amount accepted. |
maxSubscriptionAmountFloat | Largest recurring amount accepted. |
asksSubscription[Float!] | Suggested recurring amounts, shown as buttons on the form. |
allowCustomSubscriptionAmountBoolean | Whether the donor may type a recurring amount of their choice. |
shownFields[String!] | Names of the supporter fields displayed on the donation form. |
requiredFields[String!] | Names of the supporter fields the donor must fill in. |
privacyFields[String!] | Codes of the privacy definitions whose consent is asked on the donation form. |
privacyNoteString | Text shown next to the consent checkboxes on the donation form. |
customfields[CustomFieldInput!] | Values of the custom fields defined by the organization for campaigns. |
CheckoutCompleteInput
Data needed to turn a checkout session into a donation.
Arguments
| Name | Description |
|---|---|
paymentMethodIdInt | Method the donation will be collected with. Defaults to the one already chosen on the session. |
CheckoutFilters
Search filters for checkout sessions. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the data the donor entered on the form. |
stateCheckoutState | Keep only sessions in this state. |
orderString | Field to sort by, prefixed with |
tags[String!] | Keep only sessions carrying at least one of these labels. |
tagsNot[String!] | Drop the sessions carrying all of these labels. |
createDateDateRange | Keep only sessions opened in this range. |
updateDateDateRange | Keep only sessions last modified in this range. |
completedDateDateRange | Keep only sessions completed in this range. |
CheckoutInput
Data of a checkout session. Every field is optional and left untouched when omitted, so a session can be filled in step by step as the donor advances through the form.
Arguments
| Name | Description |
|---|---|
campaignIdInt | Campaign the session collects for. |
supporterIdInt | Existing supporter the session belongs to, when they are already known. |
costExampleQuantityInt | How many units of the chosen cost example the donation covers. |
peerCampaignIdInt | Peer-to-peer page the session was opened from. |
amountFloat | Amount chosen by the donor. |
frequencyFrequency | Frequency chosen by the donor. |
isPromiseBoolean | Whether the session records a promise, i.e. a donation pledged now and paid later, instead of a payment being collected right away. |
tags[String!] | Labels to attach to the donation once the session is completed. |
paymentMethodIdInt | Payment method the donor chose. |
supporterDataSupporterInput | Personal data and consents entered on the form. |
donationDataDonationInput | Fields of the donation that will be created, such as its note or its custom fields. |
deviceString | Device or channel the session was opened from. |
applicationIdInt | Application (channel) the session is opened on behalf of. |
applicationMetadataJSON | Free-form JSON the application attaches to the session and that is carried through to the donation. |
CheckoutPaymentInput
Data of the payment attempt made on a checkout session.
Arguments
| Name | Description |
|---|---|
statePaymentState | State to record the payment with, for example settled or failed. |
amountFloat | Amount collected. Defaults to the amount of the session when omitted. |
paymentDateDateTime | When the money was collected. Defaults to now when omitted. |
donationIdInt | Donation the payment belongs to. Defaults to the one of the session. |
paymentMethodIdInt | Method the money was collected with. |
peerCampaignIdInt | Peer-to-peer page the payment must be attributed to. |
creditCardIdInt | Saved card the payment was charged on. |
sepaBankAccountIdInt | Saved bank account the payment was debited from. |
stripePaymentIntentIdString | Identifier of the Stripe payment intent that collected the money. |
satispayPaymentIntentIdString | Identifier of the Satispay payment that collected the money. |
CostExampleInput
A cost example to create or update on a campaign. The list sent on CampaignInput.costExamples replaces the existing one, and examples are matched by uuid.
Arguments
| Name | Description |
|---|---|
uuidString! | Stable identifier of the example. Send the existing one to update an example, a new one to add it. |
nameString! | Short label of the example, shown on the donation form. |
descriptionString! | Longer explanation of what the amount pays for. |
amountFloat! | Amount that buys one unit of the example. |
imageIdInt | Identifier of the media shown next to the example. |
monitorQuantityBoolean! | Whether the available quantity must be tracked and the example withdrawn once exhausted. |
quantityInt! | Total number of units offered. |
availableQuantityInt! | Units still available. |
CustomFieldDefinitionCreateInput
A custom field to add to one kind of record.
Arguments
| Name | Description |
|---|---|
entityCustomFieldEntity! | Kind of record the field is defined on. Cannot be changed afterwards. |
nameString! | Label shown to operators and donors. |
descriptionString | Hint shown under the field. |
typeCustomFieldType! | Type of value the field holds. Cannot be changed afterwards. |
positionInt | Order the field is shown in. Appended last when omitted. |
options[String!] | Values to choose from. Required by the choice types. |
CustomFieldDefinitionUpdateInput
Fields of a custom field definition that can be changed. The entity and the type are fixed once created.
Arguments
| Name | Description |
|---|---|
nameString | Label shown to operators and donors. |
descriptionString | Hint shown under the field. |
positionInt | Order the field is shown in. |
options[String!] | Values to choose from. |
archivedBoolean | Whether the field is archived and no longer offered. |
CustomFieldEntityFilter
Restricts a search to the custom fields defined on one kind of record.
Arguments
| Name | Description |
|---|---|
keyString! | Key of the custom field the condition applies to. |
valueString | Value the field must hold. |
definedBoolean | Whether the field must be filled in, or must be empty. |
CustomFieldFilters
Search filters for custom field definitions. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
entityCustomFieldEntity | Keep only the fields defined on this kind of record. |
archivedBoolean | Whether to return archived definitions, active ones, or both when omitted. |
CustomFieldInput
The value to write on a custom field of a record.
Arguments
| Name | Description |
|---|---|
keyString! | Key of the definition the value belongs to. |
valueString | Value to write, serialised as a string. Null to clear it. |
DateRange
Inclusive range of dates used to filter date fields.
Arguments
| Name | Description |
|---|---|
startDate | First day accepted, inclusive. Null for no lower bound. |
endDate | Last day accepted, inclusive. Null for no upper bound. |
DateTimeRange
Inclusive range of instants used to filter timestamp fields.
Arguments
| Name | Description |
|---|---|
startDateTime | Earliest instant accepted, inclusive. Null for no lower bound. |
endDateTime | Latest instant accepted, inclusive. Null for no upper bound. |
DonationDomain
Selection of the donations an operation applies to, expressed as search filters or as a list of identifiers.
Arguments
| Name | Description |
|---|---|
filtersDonationFiltersInput | Apply the operation to every donation matching these filters. |
ids[Int!] | Apply the operation to these donations only. Takes precedence over |
DonationFiltersInput
Search filters for donations. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the code of the donation and the data of its supporter. |
archivedBoolean | Whether to include donations of archived supporters. |
orderString | Field to sort by, prefixed with |
tags[String!] | Keep only donations carrying at least one of these labels. |
tagsNot[String!] | Drop the donations carrying all of these labels. |
createDateDateRange | Keep only donations created in this range of days. |
createDatetimeDateTimeRange | Keep only donations created in this range of instants. |
updateDateDateRange | Keep only donations last modified in this range of days. |
updateDatetimeDateRange | Keep only donations last modified in this range of instants. |
completedDateDateRange | Keep only donations completed in this range of days. |
completedDatetimeDateTimeRange | Keep only donations completed in this range of instants. |
totalPaidIntRange | Keep only donations whose collected total falls in this range. |
totalPaymentsIntRange | Keep only donations whose number of payments falls in this range. |
supporterTypeSupporterType | Keep only donations from supporters of this nature. |
campaigns[Int!] | Keep only donations given to these campaigns. |
peerCampaigns[Int!] | Keep only donations collected through these peer-to-peer pages. |
supporters[Int!] | Keep only donations from these supporters. |
paymentMethods[Int!] | Keep only donations collected with these payment methods. |
channels[Int!] | Keep only donations collected through these applications (channels). |
frequencies[Frequency!] | Keep only donations with these frequencies. |
customfields[CustomFieldEntityFilter!] | Keep only donations whose custom fields match these conditions. |
importRuns[Int!] | Keep only donations created by these import runs. |
DonationInput
Fields of a donation that can be changed. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
amountFloat | New amount of a single instalment, in the currency of the organization. |
frequencyFrequency | New collection frequency of the pledge. |
noteString | Internal note attached to the donation. |
tags[String!] | Full replacement of the labels attached to the donation. |
deviceString | Device or channel the donation originated from. |
isPublicBoolean | Whether the donation may be shown publicly, for example in a donor wall. |
customfields[CustomFieldInput!] | Values of the custom fields defined by the organization for donations. |
DonationPaymentInput
Data of a payment collected outside Riseact and registered manually against a donation, such as a bank transfer or a cash gift.
Arguments
| Name | Description |
|---|---|
amountFloat | Amount collected. Defaults to the amount of the donation when omitted. |
frequencyFrequency | Frequency the payment refers to. Defaults to the frequency of the donation when omitted. |
paymentDateDateTime | When the money was actually collected. Defaults to now when omitted. |
paymentMethodIdInt | Payment method the money was collected with. |
IntRange
Inclusive range of integer values used to filter numeric fields.
Arguments
| Name | Description |
|---|---|
startInt | Smallest value accepted, inclusive. Null for no lower bound. |
endInt | Largest value accepted, inclusive. Null for no upper bound. |
LeadSupporterInput
Same fields as SupporterInput, used when registering a lead: a contact acquired before they gave anything.
Arguments
| Name | Description |
|---|---|
businessNameString | Legal name of the company, family or group. |
firstNameString | Given name. |
lastNameString | Family name. |
titleString | Courtesy title, such as Dr. or Prof. |
externalRefString | Identifier of the supporter in the external system they come from. Must be unique inside the organization. |
supporterTypeSupporterType | Nature of the supporter, which decides whether the personal or the business fields apply. |
emailString | Main email address, used for receipts and notifications. |
phoneString | Landline number. |
mobileString | Mobile number, used for SMS notifications. |
jobString | Job or role declared by the supporter. |
sexSex | Gender recorded on the supporter. |
dateOfBirthDate | Date of birth, required by some tax receipt regimes. |
placeOfBirthString | Place of birth, required by some tax receipt regimes. |
ssnString | National tax identifier of the person (in Italy, the codice fiscale). |
vatString | VAT number of the company. |
addressString | Street address. |
address2String | Second address line, for care-of details or the like. |
cityString | City of the address. |
localityString | Locality or province of the address. |
countryString | Country of the address. |
postalCodeString | Postal code of the address. |
emailMarketingBoolean | Consent to receive marketing messages by email. |
phoneMarketingBoolean | Consent to be contacted for marketing by phone. |
smsMarketingBoolean | Consent to receive marketing messages by SMS. |
postalMarketingBoolean | Consent to receive marketing material by post. |
profilationMarketingBoolean | Consent to have their data profiled for marketing purposes. |
noteString | Internal note attached to the supporter. |
certificationUrlString | URL of the signed acquisition document collected for the supporter. |
imageString | URL of the profile picture to attach to the supporter. |
tags[String!] | Full replacement of the labels attached to the supporter. |
customfields[CustomFieldInput!] | Values of the custom fields defined by the organization for supporters. |
privacyValues[SupporterPrivacyInput!] | Consents to record on the supporter, one entry per privacy definition. |
sourceCampaignIdInt | Campaign the supporter was acquired through. |
sourcePeerCampaignIdInt | Peer-to-peer page the supporter was acquired through. |
ManualPaymentInput
Fields of a payment that can be corrected by hand, such as the date it was actually collected.
Arguments
| Name | Description |
|---|---|
amountFloat! | Corrected amount of the payment. |
paymentDateDateTime! | Corrected date the money was collected on. |
paymentMethodIdInt | Corrected method the money was collected with. |
ManualPaymentMethodInput
Configuration of a payment method collected outside Riseact, such as a bank transfer, a cash gift or a direct debit handled by the bank.
Arguments
| Name | Description |
|---|---|
labelString! | Name shown to the donor on the payment step. |
hasOneoffSupportBoolean | Whether the method can collect one-off donations. |
hasSubscriptionSupportBoolean | Whether the method can collect recurring donations. |
descriptionString | Short explanation shown to the donor under the label. |
instructionsString | Instructions the donor must follow to pay, such as the bank details for a transfer. |
channels[Int!] | Identifiers of the applications (channels) the method is offered on. Empty means every channel. |
includeInCertificateBoolean | Whether payments collected with this method are counted in the yearly tax certificate of the supporter. |
sendInstructionsBoolean | Whether the instructions are emailed to the donor after the donation. |
MenuInput
Name, handle and entries of a navigation menu. The entries sent replace the existing ones.
Arguments
| Name | Description |
|---|---|
nameString! | Name of the menu, shown in the back-office. |
handleString! | Stable handle the theme calls the menu by. |
items[MenuItemInput!]! | Entries of the menu, in the order they must be shown. Replaces the existing ones. |
MenuItemInput
One entry of a navigation menu.
Arguments
| Name | Description |
|---|---|
labelString! | Text shown in the menu. |
linkString | Address the entry points at. Null for entries pointing at a page of the site chosen elsewhere. |
OrganizationInput
Fields of the organization that can be written. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
nameString! | Name of the organization, shown to donors. |
logoInt | Media used as logo of the organization. |
legalNameString | Registered name, used on receipts and invoices. |
currencyCurrencies! | Currency donations are collected in. |
isInvoiceRequiredBoolean | Whether the organization needs an invoice for what it is billed. |
vatString | VAT number of the organization. |
vatExchangeString | Code or address the electronic invoices must be delivered to. |
taxIdentificationNumberString | Tax identifier printed on the receipts issued to donors. |
senderEmailString | Address the notifications are sent from. The DNS checks must pass before it is used. |
contactEmailString | Email address donors are invited to write to. |
contactPhoneString | Phone number donors are invited to call. |
addressLine1String | Street address of the registered office. |
addressLine2String | Second address line of the registered office. |
cityString | City of the registered office. |
stateString | State or province of the registered office. |
countryString | Country of the registered office. |
postalCodeString | Postal code of the registered office. |
annualCertificateAutoSendBoolean | Whether the yearly tax certificates are sent to supporters automatically. |
annualCertificateSendMonthInt | Month of the year the certificates are sent in, as a number from 1 to 12. |
annualCertificateSendDayInt | Day of the month the certificates are sent on. |
OrganizationLegalInput
Legal texts and consents shown by the organization on its public site and donation forms.
Arguments
| Name | Description |
|---|---|
tosString! | Terms of service, as HTML. |
privacyPolicyString! | Privacy policy, as HTML. |
consentScopes[String!]! | Codes of the consents asked to donors by default. |
OrganizationsFilters
Search filters for the organizations the caller has access to.
Arguments
| Name | Description |
|---|---|
nameString | Keep only organizations whose name matches. |
PageInput
Fields of a static page that can be written. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
titleString | Title of the page. |
contentString | Body of the page, as HTML. |
visibilityWebDocumentVisibility | Whether the page is public, reachable only by direct link, or hidden. |
slugString | URL segment of the page. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the page. |
coverIdInt | Media used as cover image of the page. |
PagesFiltersInput
Search filters for static pages.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title and the content of the page. |
PaginationInput
Cursor pagination arguments. Use first/after to walk forward and last/before to walk backwards; first and last cannot be combined. Defaults to the first 25 items.
Arguments
| Name | Description |
|---|---|
firstInt | Number of items to take from the start of the page. Defaults to 25. |
lastInt | Number of items to take from the end of the page. Cannot be combined with |
afterString | Return the items that follow this cursor. |
beforeString | Return the items that precede this cursor. |
PaymentDomain
Selection of the payments an operation applies to, expressed as search filters.
Arguments
| Name | Description |
|---|---|
filtersPaymentFiltersInput | Apply the operation to every payment matching these filters. |
ids[Int!] | Apply the operation to these payments only. Takes precedence over |
PaymentFiltersInput
Search filters for payments. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the data of the supporter and the codes of the donation. |
supporterInt | Keep only the payments of this supporter. |
donationInt | Keep only the payments of this donation. |
paymentMethodInt | Keep only the payments collected with this method. |
paymentDateDateRange | Keep only payments collected in this range. |
state[PaymentState!] | Keep only payments in these states. |
orderString | Field to sort by, prefixed with |
createDateDateRange | Keep only payments created in this range. |
updateDateDateRange | Keep only payments last modified in this range. |
PeerCampaignFilters
Search filters for peer-to-peer pages. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title of the page and the name of the fundraiser. |
ids[Int!] | Restrict the results to these pages. |
orderString | Field to sort by, prefixed with |
tags[String!] | Keep only pages carrying at least one of these labels. |
tagsNot[String!] | Drop the pages carrying all of these labels. |
channels[String!] | Keep only pages offered on these applications (channels). |
supporterIdInt | Keep only the pages of this fundraiser. |
campaignIdInt | Keep only the pages collecting for this campaign. |
PeerCampaignInput
Fields of a peer-to-peer page that can be written. The supporter and the parent campaign are required; everything else is optional and left untouched when omitted.
Arguments
| Name | Description |
|---|---|
supporterIdInt! | Supporter who is fundraising. |
campaignIdInt! | Campaign the page collects for. |
titleString | Title of the page. |
contentString | Body of the page, as HTML. |
visibilityWebDocumentVisibility | Whether the page is public, reachable only by direct link, or hidden. |
slugString | URL segment of the page. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the page. |
thankyouTemplateString | Name of the theme template rendering the thank-you page. |
coverIdInt | Media used as cover image of the page. |
isGoalEnabledBoolean | Whether the goal and its progress bar are shown on the page. |
goalFloat | Amount the fundraiser aims to raise. |
supporterNameString | Name of the fundraiser as shown on the page. |
customMessageString | Personal appeal written by the fundraiser. |
receiptNotificationIdInt | Notification used to send the receipt for donations collected on this page. |
PrivacyDefinitionCreateInput
A consent to add to the ones the organization asks donors for.
Arguments
| Name | Description |
|---|---|
codeString! | Stable code the consent is recorded under. Must be unique inside the organization. |
labelString! | Short label shown next to the checkbox. |
messageString | Full text of the consent. |
isDefaultBoolean | Whether the consent is asked on every donation form by default. |
isRequiredBoolean | Whether the donor must give the consent to be able to donate. |
consentScopes[String!] | Marketing permissions the consent grants. |
PrivacyDefinitionFilters
Search filters for consent definitions. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
codeString | Keep only the consent with this code. |
labelString | Keep only consents whose label matches. |
isDefaultBoolean | Keep only the consents asked by default, or only the others. |
isRequiredBoolean | Keep only the mandatory consents, or only the optional ones. |
PrivacyDefinitionUpdateInput
Fields of a consent definition that can be changed. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
codeString | Stable code the consent is recorded under. |
labelString | Short label shown next to the checkbox. |
messageString | Full text of the consent. |
isDefaultBoolean | Whether the consent is asked on every donation form by default. |
isRequiredBoolean | Whether the donor must give the consent to be able to donate. |
consentScopes[String!] | Marketing permissions the consent grants. |
ProjectFilters
Search filters for projects. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the title and the content of the project. |
orderString | Field to sort by, prefixed with |
ProjectInput
Fields of a project that can be written, its public page included. Every field is optional: omitted fields are left untouched.
Arguments
| Name | Description |
|---|---|
titleString! | Title of the project page. |
contentString | Body of the project page, as HTML. |
visibilityWebDocumentVisibility | Whether the page is public, reachable only by direct link, or hidden. |
slugString | URL segment of the page. Generated from the title when omitted. |
seoTitleString | Title used by search engines. |
seoDescriptionString | Meta description used by search engines and link previews. |
templateString | Name of the theme template rendering the page. |
coverIdInt | Media used as cover image of the page. |
typeProjectType | How the campaigns are chosen: listed by hand or matched by rules. |
rulesMatchProjectRuleMatchType | Whether a campaign must satisfy every rule or just one of them. |
campaignsOrderProjectCampaignsOrder | Order the campaigns are listed in. |
rules[ProjectRuleInput!] | Full replacement of the rules of the project. |
ProjectRuleInput
A condition to add to a project. The list sent on ProjectInput.rules replaces the existing one, and rules are matched by uuid.
Arguments
| Name | Description |
|---|---|
fieldProjectRuleField! | Field of the campaign the rule looks at. |
operatorProjectRuleOperator! | How the field is compared with the value. |
valueString! | Value the field is compared with. |
uuidString! | Stable identifier of the rule. Send the existing one to update a rule, a new one to add it. |
RedirectInput
The path to redirect and where to send it.
Arguments
| Name | Description |
|---|---|
sourcePathString! | Path on the site to redirect, leading slash included. |
destinationUrlString! | Address visitors are sent to. |
RedirectsFiltersInput
Search filters for redirects.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the path and the destination of the redirect. |
SegmentFiltersInput
Search filters for saved segments. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
entitySegmentEntity! | Keep only the segments searching over this kind of record. |
qString | Free-text search over the name of the segment. |
orderString | Field to sort by, prefixed with |
SegmentInput
Name, kind of record and filters of a saved segment.
Arguments
| Name | Description |
|---|---|
nameString! | Name of the segment. |
entitySegmentEntity! | Kind of record the segment searches over. |
filtersString! | Filters of the segment, as a JSON string in the shape taken by the search of that record. |
StripePaymentTypeInput
Which Stripe payment methods the intent must accept.
Arguments
| Name | Description |
|---|---|
types[StripePaymentType!]! | Payment methods the intent must accept. Defaults to the ones enabled for the organization. |
SumUpAccountInput
The SumUp merchant to collect payments for.
Arguments
| Name | Description |
|---|---|
merchantCodeString | Code of the merchant on SumUp. Null to disconnect the account. |
SupporterDomain
Selection of the supporters an operation applies to, expressed as search filters.
Arguments
| Name | Description |
|---|---|
filtersSupporterFiltersInput | Apply the operation to every supporter matching these filters. |
ids[Int!] | Apply the operation to these supporters only. Takes precedence over |
SupporterFiltersInput
Search filters for supporters. Filters are combined with a logical AND.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over name, business name, email, phone, tax identifiers, postal code and address. |
archivedBoolean | Whether to return archived supporters, active ones, or both when omitted. |
ids[Int!] | Restrict the results to these supporters. |
orderString | Field to sort by, prefixed with |
typeSupporterType | Keep only supporters of this nature. |
cityString | Keep only supporters whose city matches. |
countryString | Keep only supporters whose country matches. |
createDateDateRange | Keep only supporters created in this range. |
updateDateDateRange | Keep only supporters last modified in this range. |
sexSexFilter | Keep only supporters of this gender, |
campaigns[Int!] | Keep only supporters who gave to, or were acquired through, these campaigns. |
firstDonationDateDateRange | Keep only supporters whose first donation falls in this range. |
lastDonationDateDateRange | Keep only supporters whose last donation falls in this range. |
totalDonatedIntRange | Keep only supporters whose total given falls in this range. |
totalDonationsIntRange | Keep only supporters whose number of donations falls in this range. |
peerCampaigns[Int!] | Keep only supporters who gave through these peer-to-peer pages. |
havePhoneBoolean | Keep only supporters with, or without, a phone number. |
haveEmailBoolean | Keep only supporters with, or without, an email address. |
haveVatBoolean | Keep only supporters with, or without, a VAT number. |
haveSsnBoolean | Keep only supporters with, or without, a national tax identifier. |
dateOfBirthDateRange | Keep only supporters born in this range. |
placeOfBirthString | Keep only supporters born in this place. |
emailMarketingBoolean | Keep only supporters who did, or did not, consent to marketing by email. |
phoneMarketingBoolean | Keep only supporters who did, or did not, consent to marketing by phone. |
smsMarketingBoolean | Keep only supporters who did, or did not, consent to marketing by SMS. |
postalMarketingBoolean | Keep only supporters who did, or did not, consent to marketing by post. |
profilationMarketingBoolean | Keep only supporters who did, or did not, consent to profiling. |
privacyValues[String!] | Keep only supporters who accepted every consent with these codes. |
tags[String!] | Keep only supporters carrying at least one of these labels. |
tagsNot[String!] | Drop the supporters carrying all of these labels. |
isOneoffSupporterBoolean | Keep only supporters who gave one-off donations. |
isRegularSupporterBoolean | Keep only supporters with a recurring pledge. |
emailString | Keep only the supporter with exactly this email address. |
ssnString | Keep only the supporter with exactly this national tax identifier. |
phoneString | Keep only supporters whose landline or mobile contains this text. |
customfields[CustomFieldEntityFilter!] | Keep only supporters whose custom fields match these conditions. |
importRuns[Int!] | Keep only supporters created by these import runs. |
channels[Int!] | Keep only supporters acquired through these applications (channels). |
queryString | Advanced search written in the DjangoQL query language, for conditions the other filters cannot express. |
SupporterInput
Fields of a supporter that can be written. Every field is optional: omitted fields are left untouched, so the same input works for creation and update.
Arguments
| Name | Description |
|---|---|
businessNameString | Legal name of the company, family or group. |
firstNameString | Given name. |
lastNameString | Family name. |
titleString | Courtesy title, such as Dr. or Prof. |
externalRefString | Identifier of the supporter in the external system they come from. Must be unique inside the organization. |
supporterTypeSupporterType | Nature of the supporter, which decides whether the personal or the business fields apply. |
emailString | Main email address, used for receipts and notifications. |
phoneString | Landline number. |
mobileString | Mobile number, used for SMS notifications. |
jobString | Job or role declared by the supporter. |
sexSex | Gender recorded on the supporter. |
dateOfBirthDate | Date of birth, required by some tax receipt regimes. |
placeOfBirthString | Place of birth, required by some tax receipt regimes. |
ssnString | National tax identifier of the person (in Italy, the codice fiscale). |
vatString | VAT number of the company. |
addressString | Street address. |
address2String | Second address line, for care-of details or the like. |
cityString | City of the address. |
localityString | Locality or province of the address. |
countryString | Country of the address. |
postalCodeString | Postal code of the address. |
emailMarketingBoolean | Consent to receive marketing messages by email. |
phoneMarketingBoolean | Consent to be contacted for marketing by phone. |
smsMarketingBoolean | Consent to receive marketing messages by SMS. |
postalMarketingBoolean | Consent to receive marketing material by post. |
profilationMarketingBoolean | Consent to have their data profiled for marketing purposes. |
noteString | Internal note attached to the supporter. |
certificationUrlString | URL of the signed acquisition document collected for the supporter. |
imageString | URL of the profile picture to attach to the supporter. |
tags[String!] | Full replacement of the labels attached to the supporter. |
customfields[CustomFieldInput!] | Values of the custom fields defined by the organization for supporters. |
privacyValues[SupporterPrivacyInput!] | Consents to record on the supporter, one entry per privacy definition. |
sourceCampaignIdInt | Campaign the supporter was acquired through. |
sourcePeerCampaignIdInt | Peer-to-peer page the supporter was acquired through. |
SupporterPrivacyInput
A consent to record on a supporter, referring to one of the privacy definitions of the organization.
Arguments
| Name | Description |
|---|---|
codeString! | Code of the privacy definition the consent refers to. |
valueBoolean! | Whether the consent was given. |
dateString | When the consent was collected, as an ISO 8601 string. Defaults to now when omitted. |
TerminalLocationFilters
Search filters for the locations card readers are installed at.
Arguments
| Name | Description |
|---|---|
qString | Free-text search over the name of the location. |
TerminalLocationInput
Address of a place card readers are installed at.
Arguments
| Name | Description |
|---|---|
displayNameString! | Name of the location, shown in the back-office. |
addressCityString! | City of the location. |
addressCountryString! | Country of the location, as a two-letter code. |
addressLine1String! | Street address of the location. |
addressLine2String | Second address line of the location. |
addressPostalCodeString! | Postal code of the location. |
addressStateString! | State or province of the location. |
TerminalRegisterInput
Data needed to pair a card reader with the Stripe account of the organization.
Arguments
| Name | Description |
|---|---|
labelString! | Name of the reader, shown in the back-office. |
registrationCodeString! | Pairing code shown on the screen of the reader. |
locationIdString! | Location the reader is installed at. |