Open source · Self-hosted · API-first

Contact passes,
ready for Wallet.

Turn contact details into polished Apple Wallet passes or Google Wallet save links. A small, self-hosted API puts pass creation right in your apps and automations.

Your service, your infrastructure, your API key.
Apple Wallet
Google Wallet
API-key protected Customizable pass branding vCard QR on every pass Workato connector included
One contact API, two wallets

Make every introduction count.

Generate useful, on-brand contact passes from the same structured contact data, then fit pass creation into the systems you already use.

Apple Wallet passes

Return a ready-to-save .pkpass with contact details, configurable colors, optional profile thumbnail, and a scannable vCard QR code.

Google Wallet save links

Create a signed save URL for a Google Wallet Generic Pass, along with its object ID. Recipients can add the contact right to their wallet.

Contact data that travels

Every pass QR encodes a vCard 3.0 contact. Scan it to add the submitted details directly to a phone's address book.

Simple HTTP interface

Send JSON to a small REST API protected by an API key. Use the interactive docs and OpenAPI specification to integrate your stack.

Automation-ready

Use the included Workato connector to create an Apple pass or Google Wallet link as part of your business workflows.

Deploy on your terms

Run it with Docker Compose, a Docker container, or Kubernetes. Keep API access and signing credentials in your own environment.

A developer-friendly API

One request to make it real.

Post a contact once, and get back a downloadable Apple pass. Or request a Google Wallet save link from the same service.

POST/passesApple Wallet .pkpass
POST/passes/google-walletGoogle Wallet save link
GET/healthService health check
Request · Apple Wallet passcurl
# Save the response as a .pkpass file
curl -X POST http://localhost:8000/passes \
  -H "X-API-Key: $API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "givenName": "Ada",
    "surname": "Lovelace",
    "academicDegree": "PhD",
    "company": "Analytical Engines",
    "email": "ada@example.org",
    "phoneNumber": "+1 555 0100",
    "department": "Computing",
    "street": "1 Main St",
    "postalCode": "SW1A 1AA",
    "city": "London",
    "country": "UK"
  }' \
  -o contact.pkpass
Fits your infrastructure

Pick your path to production.

Get started locally, then deploy wherever your team runs services.

01 / QUICK START

Docker Compose

Pull the published container and bring the API up with Compose. A configured API key is required.

View setup instructions
02 / CONTAINER

Docker

Build and run the image yourself, then connect applications to your service over HTTP.

View setup instructions
03 / CLUSTER

Kubernetes

Deploy with the included manifest and configure your API and wallet credentials as Kubernetes Secrets.

View setup instructions
Apple Wallet setup: The default unsigned mode is for development and inspection; unsigned packages cannot be installed in Apple Wallet. Production-ready Apple passes require valid Pass Type ID signing credentials. Google Wallet links also require an issuer, an approved Generic Class, and an authorized service account.
Ready when you are

Build a better way to share contact details.

Explore the code, read the setup guide, and make it your own.