Skip to main content

Dec 31

🎉 New feature​

Membership Management API​

You can now use Ticket Tailor's API to create and manage membership types and issued memberships programmatically. This is useful if you're building custom integrations or want to automate membership management for your events.

Membership Types​

Create, view, update, and delete membership types with fixed or relative validity periods:

  • List membership types – GET /v1/membership_types returns paginated membership types
  • Create membership type – POST /v1/membership_types creates a new membership type with required fields (name, valid_from_type, valid_to_type) and optional settings like max_redemptions, conditions_and_benefits, and photo_required
  • Get membership type – GET /v1/membership_types/{membership_type_id} retrieves a single membership type
  • Update membership type – POST /v1/membership_types/{membership_type_id} updates an existing membership type
  • Delete membership type – DELETE /v1/membership_types/{membership_type_id} deletes a membership type (only if it has no issued memberships and no linked products)

Issued Memberships​

Create, view, update, and void individual memberships for your members:

  • List issued memberships – GET /v1/issued_memberships with filters for member details (first_name, last_name, email, search), membership code, validity status (valid, invalid, both), and timestamps (created_at, updated_at)
  • Create issued membership – POST /v1/issued_memberships creates a new membership with member details (membership_type_id, first_name, last_name, email) and optional validity date overrides
  • Get issued membership – GET /v1/issued_memberships/{issued_membership_id} retrieves a single issued membership
  • Update issued membership – POST /v1/issued_memberships/{issued_membership_id} updates an existing issued membership (only fixed date types allowed when updating)
  • Void issued membership – POST /v1/issued_memberships/{issued_membership_id}/void voids a membership, preventing future redemptions
  • Get membership photo – GET /v1/membership_photo_share returns a temporary signed URL for the issued membership photo

Redemptions​

Record when a member uses their membership to enter an event:

  • Create redemption – POST /v1/issued_membership_redemptions/{event_id} records a redemption by membership code, tracking how many times the membership has been used

💡 Things to note:

  • Voiding a membership prevents it from being used for future redemptions, but doesn't delete it
  • You can only delete a membership type if it has no issued memberships and no linked products
  • All dates in the API use Unix timestamps in UTC
  • When creating a membership type, choose 'fixed' dates (requires valid_from_date and valid_to_date) or 'relative' dates (requires valid_to_interval_days between 1 and 365 days)