No Frills Dev API

The AddPass developer API is designed for engineers seeking a simple solution to generate pkpass files for their applications or automations.

Focused on simplicity, the single endpoint generates generic template Apple Wallet passes. You can choose to stream the pkpass file or receive a json response with a short lived download link by toggling the "Accept" header from application/json to application/pkpass.

While simple, you have access to the full set of pass fields, colors, geolocation alerts, images, and more. See the full documentation in the developer portal.

Get Started with Developer Tools

Starting at 9.99 | 2K Generations /mo

import { writeFile } from 'node:fs/promises';

const payload = {
  primaryText: 'Summer Gala',
  headerLabelRight: 'Admit One',
  backgroundColor: '#0F1219',
  thumbnailURL: 'https://cdn.example.com/passes/gala.png',
  barcode: { 
  	format: 'qr',
    message: 'https://example.com/tickets/12345'
  },
};

const response = await fetch('https://app.addpass.io/api/v1/generate', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_KEY_HERE',
    'Content-Type': 'application/json',
    'Accept': 'application/pkpass',
  },
  body: JSON.stringify(payload),
});

if (!response.ok) {
  throw new Error('Generation failed');
}

const buffer = Buffer.from(await response.arrayBuffer());
await writeFile('summer-gala.pkpass', buffer);

Sample JSON

Simple json payload to customize and create exactly the pass you need.

{
  "backgroundColor": "#0F1219",
  "foregroundColor": "#FFFFFF",
  "labelColor": "#FFFFFF",
  "primaryText": "Your Event Name",
  "headerLabelRight": "Admit",
  "headerTextRight": "One",
  "secondaryLabelLeft": "Date",
  "secondaryTextLeft": "August 24, 2025",
  "secondaryLabelRight": "Doors",
  "secondaryTextRight": "6:30 PM",
  "auxiliaryLabelLeft": "Seat",
  "auxiliaryTextLeft": "B12",
  "auxiliaryLabelRight": "Gate",
  "auxiliaryTextRight": "North Entrance",
  "backFields": [
    {
      "label": "Support",
      "value": "support@yourdomain.com"
    },
    {
      "label": "Terms",
      "value": "https://yourdomain.com/terms"
    },
    {
      "label": "Help Desk",
      "value": "(555) 123-9876"
    }
  ],
  "barcode": {
    "format": "qr",
    "message": "https://yourdomain.com/check-in/{{token}}"
  }
}

FOR DEVELOPERS

No Frills Dev API

Get Started with Developer Tools

Sample JSON