Apple Wallet Templates

Templates control the colours, text and images on your Apple Wallet passes. Use the pass designer for a live preview, or create a template through the API.

Create a template

const { data: template, error } = await eventlayer.appleWalletTemplates.create({
  backgroundColor: "rgb(60, 60, 60)",
  foregroundColor: "rgb(255, 255, 255)",
  logoText: "After Hours",
});
if (error) throw error;

Apply it to an event

const { error } = await eventlayer.events.update({
  eventId: "ev_123",
  appleWalletTemplateId: template.id,
});
if (error) throw error;

Now generate a Wallet pass for an assigned ticket.

Override it for a ticket type

Assign appleWalletTemplateId with eventlayer.ticketTypes.update() to give a type its own design. Ticket-type fields take precedence; null fields fall back to the event template. Set an assignment to null to remove it.

Upload an image

Pass your uploaded file to the SDK:

const { error } = await eventlayer.appleWalletTemplates.uploadImage({
  templateId: "awt_123",
  imageType: "hero",
  file,
  contentType: "image/png",
});
if (error) throw error;

Template properties

The template values are written into the pass JSON during generation.

Apple requires appLaunchURL to be paired with an associated App Store app. Contact Eventlayer support to enable this integration for your account. If it is not enabled, Eventlayer safely omits appLaunchURL from the pass.

The response also includes hero_image_url, logo_image_url, and background_image_url. These are read-only: they are set by the image upload endpoint below, not via create or update.

Image types

Images are uploaded as multipart/form-data to POST /v1/apple-wallet-templates/{id}/images (fields: image_type and file). Uploads are validated before storage: formats PNG, JPEG, or WebP, max 10MB, and within the maximum dimensions for the slot.

See the API reference for listing, updating and deleting templates.