Vouchers

Allowances and benefits issued to employees — a meal allowance, a commute budget, a one-off credit.

Two ways to work: create vouchers directly, or define a template and generate from it. Templates are the better path once you are issuing the same thing repeatedly.

Vouchers

query {
  vouchers(
    first: 50
    isActive: true
    search: "lunch"
  ) {
    nodes { id }
    pageInfo { hasNextPage endCursor }
  }
}

Cursor-paginated, filterable by isActive and a free-text search. voucher(voucherId:) fetches one.

Mutation	Effect
`createVoucher(input:)`	Issue a voucher
`updateVoucher(voucherId:, input:)`	Modify
`deleteVoucher(voucherId:)`	Remove; returns `true`

Requires enterprise:vouchers:read / :write.

Templates

query {
  voucherTemplates(
    first: 50
    isActive: true
    voucherType: "meal"
  ) {
    nodes { id }
    pageInfo { hasNextPage endCursor }
  }
}

Cursor-paginated, filterable by isActive and voucherType. voucherTemplate(templateId:) fetches one and returns null if absent.

Note voucherType is a plain String, not an enum — valid values are not published in the schema.

Mutation	Effect
`createVoucherTemplate(input:)`	Define a template
`updateVoucherTemplate(templateId:, input:)`	Modify
`deleteVoucherTemplate(templateId:)`	Remove; returns `true`
`duplicateVoucherTemplate(templateId:, newName:)`	Copy under a new name

duplicateVoucherTemplate is the quickest way to build a variant — copy, then adjust — rather than rebuilding an input object from scratch.

Generating from a template

mutation {
  generateVoucherFromTemplate(input: { ... }) {
    id
  }
}

Returns the created voucher. This is the operation to automate: define the policy once as a template, then generate per employee, per month, or per event.

Usage and analytics

query {
  voucherUsageStats(voucherId: 9) { ... }
}

Per-voucher redemption statistics.

query {
  voucherAnalytics(
    startDate: "2026-07-01T00:00:00Z"
    endDate: "2026-08-01T00:00:00Z"
  ) { ... }
}

Aggregate analytics across the enterprise. Both dates are optional — omit them for all time.

Reference

Generated reference — every type, field and argument, built from the live schema.

Enterprise settings Enterprise billing

Built with