TItickettailor
Issued memberships

Create an issued membership

Creates a new issued membership for membership type

post/v1/issued_memberships

Request

Request body application/x-www-form-urlencoded

membership_type_idstring required

The ID of the membership type (e.g. mt_123)

first_namestring required

First name

last_namestring required

Last name

emailstring email required

Email address

photostring binary

Photo (max 5MB)

valid_from_type'fixed' | 'relative'

Type of valid from date. 'fixed' uses valid_from_date, 'relative' uses the date of issue. When not provided, the membership type's default is used.

valid_from_dateinteger

Unix timestamp (UTC) for when the issued membership becomes valid. Required if valid_from_type is 'fixed'. When not provided, the membership type's default is used.

valid_to_type'fixed' | 'relative'

Type of valid to date. 'fixed' uses valid_to_date, 'relative' uses valid_to_interval_days from issue date. When not provided, the membership type's default is used.

valid_to_dateinteger

Unix timestamp (UTC) for when the membership expires. Required if valid_to_type is 'fixed'. When not provided, the membership type's default is used.

valid_to_interval_daysinteger

Number of days the membership is valid for from the issue date. Used when valid_to_type is 'relative'. Must be between 1 and 1095. When not provided, the membership type's default is used.

max_redemptionsstring

Maximum number of times the issued membership can be redeemed. If not provided, the membership type's default is used. Provide empty string to set unlimited redemptions.

Example request

{
  "membership_type_id": "mt_123",
  "first_name": "John",
  "last_name": "Doe",
  "email": "john.doe@example.com",
  "valid_from_date": 1704067200,
  "valid_to_date": 1735689600,
  "valid_to_interval_days": 365,
  "max_redemptions": "10"
}

Response

Successfully created an issued membership

objectstring

Object type identifier

idstring

A unique identifier for the issued membership

codestring

Unique membership code for identification and redemption

benefitsstring[]

List of benefits associated with this membership

emailstring

Email address of the member

first_namestring

First name of the member

full_namestring

Full name of the member

is_valid'true' | 'false'

Whether the membership is currently valid (not expired and not voided)

last_namestring

Last name of the member

max_redemptionsinteger nullable

Maximum number of redemptions allowed. Null means unlimited.

membership_type_idstring

ID of the membership type

membership_type_namestring

Name of the membership type

redemptionsinteger

Number of times this membership has been redeemed

Example response

{
  "object": "issued_membership",
  "id": "im_123",
  "code": "MMABC123",
  "benefits": [
    "Free entry to all events",
    "10% discount on merchandise"
  ],
  "email": "john.doe@example.com",
  "first_name": "John",
  "full_name": "John Doe",
  "is_valid": "true",
  "issue_date": {
    "date": "2024-01-01",
    "formatted": "Mon 1 Jan 2024 12:00 PM",
    "iso": "2024-01-01T12:00:00+00:00",
    "time": "12:00",
    "timezone": "+00:00",
    "unix": 1704110400
  },
  "last_name": "Doe",
  "max_redemptions": 10,
  "membership_type_id": "mt_456",
  "membership_type_name": "Annual Pass",
  "redemption_collection": [],
  "redemptions": 0,
  "valid_from": {
    "date": "2024-01-01",
    "formatted": "Mon 1 Jan 2024 12:00 PM",
    "iso": "2024-01-01T12:00:00+00:00",
    "time": "12:00",
    "timezone": "+00:00",
    "unix": 1704110400
  },
  "valid_to": {
    "date": "2024-12-31",
    "formatted": "Tue 31 Dec 2024 11:59 PM",
    "iso": "2024-12-31T23:59:59+00:00",
    "time": "23:59",
    "timezone": "+00:00",
    "unix": 1735689599
  },
  "voided_at": null
}

Changes

No recorded changes to this operation across all 6 revisions of this API.