Skip to main content
POST
Create program pass template

Authorizations

Authorization
string
header
required

API key authentication. Include your API key as a Bearer token.

Example: Bearer sk_prod_xxxxxx

Get your API key from the Stell Dashboard.

Path Parameters

programId
string
required

Body

application/json

Request body for creating a new pass template within a program

userInfo
object

Custom user information stored with the pass

backFields
object[]

Fields displayed on the back of the pass

associatedStoreIdentifiers
string[]

Associated App Store app identifiers

App Store identifier

description
string

Pass template description

Maximum string length: 500
publicKey
string

Public key for pass authentication

auxiliaryFields
object[]

Auxiliary fields displayed in a supporting role

enableGoogleSmartTap
boolean

Enable Google Smart Tap for NFC interactions

colors
object

Color scheme configuration for the pass

sharingProhibited
boolean

Whether pass sharing is prohibited

defaultLanguage
string

Default language code for the pass

Pattern: ^[a-z]{2}(-[A-Z]{2})?$
passStyle
enum<string>

Visual style of the pass template

Available options:
GENERIC_CARD,
COUPON,
EVENT_TICKET,
BOARDING_PASS,
STORE_CARD
supportedLanguages
string[]

Supported language codes for localization

IETF BCP 47 language tag

Pattern: ^[a-z]{2}(-[A-Z]{2})?$
headerFields
object[]

Header fields displayed at the top of the pass

expirationDate
string

Pass expiration date in ISO 8601 format

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$
logoText
string

Text displayed next to the logo

Maximum string length: 50
organizationName
string

Organization name displayed on the pass

Maximum string length: 100
relevantDates
object[]

Lock-screen relevance entries. Each entry is either a single moment ({ relevantDate }) or an interval ({ startDate, endDate }), all in ISO 8601 format.

secondaryFields
object[]

Secondary fields displayed below primary fields

semanticTags
object

Semantic tags for Apple Wallet passes: seating, flight, event and location details that Wallet and Siri use for suggestions. All fields are optional; send the ones that apply to your pass type.

maxDistance
integer

Maximum distance in meters for location relevance

Required range: x >= 1
primaryFields
object[]

Primary fields displayed prominently on the pass

barcodes
object[]

Barcode configurations for the pass

sharing
string

Pass sharing configuration

beacons
object[]

Beacon configurations for proximity notifications

personalize
object

Personalization configuration for the pass

appLaunchURL
string<uri>

URL to launch when pass is tapped

messages
string[]

Custom messages for the pass

One custom message

locations
object[]

Location-based notifications for the pass

status
enum<string>

Initial template lifecycle status (defaults to DRAFT)

Available options:
DRAFT,
ACTIVE,
INACTIVE

Response

201 response

Response envelope carrying a pass template.

data
PassTemplate · object
required
requestId
string
required

Unique request identifier for debugging

Pattern: ^[0-9A-Z]{26}$