nomiDocumentation
SupportBack to site
  • Getting started

    • Introduction
    • What is Nomi?
    • Quick start
    • Concepts
    • Authentication
  • Credentials

    • Create a credential
    • Issue a credential
    • Credential lifecycle
    • Revoke a credential
    • Verify a credential
    • QR verification
  • Distribution

    • Apple Wallet
    • Google Wallet
    • Email
    • Credential delivery
    • Bulk issuance
  • API

    • API overview
    • Authentication
    • Credentials API
    • Recipients
    • Verification
    • Revocation
    • Webhooks
    • Errors
  • Integrations

    • Moodle
    • WordPress
    • REST API
    • Webhooks
  • Security

    • Authentication
    • API keys
    • Webhook security
    • Data protection
    • Best practices
  • Resources

    • FAQ
    • Glossary
    • Changelog
  1. Documentation
  2. /
  3. Distribution
  4. /
  5. Email

Email

Sending a credential to somebody's inbox, and what the message actually contains.

An email is a distribution with channel: "email". Nomi sends the message and tracks what happened to it; what travels inside is the same link as every other channel.

POST /v1/distributions

curl -X POST https://api.nomi-tech.com/v1/distributions \
  -H "Authorization: Bearer nomi_sk_live_EXAMPLE" \
  -H "Content-Type: application/json" \
  -d '{
    "credentialId": "cred_…",
    "channel": "email",
    "wallet": "apple_wallet",
    "recipientName": "Alex Morgan",
    "recipientEmail": "alex@example.com",
    "message": "Your membership card for 2026."
  }'

channel is how it travels and wallet is where the pass ends up. They are separate on purpose — an email can land in Google Wallet and a QR code in Apple Wallet — and wallet: "web" is the honest answer for a desktop: the public page is the credential.

What you can see afterwards

A distribution moves through created, ready, opened, delivered, installed — or failed, expired, revoked. GET /v1/distributions is the same table the Distribution Center shows, filtered by credential, channel, wallet or status.

Sending to many people

Bulk sends are queued rather than sent in a burst, with a ceiling per hour, so a graduation of four hundred does not get the whole batch treated as spam. See Bulk issuance.

Bulk issuance

Groups, campaigns and queues.

Recipients

Who receives what.

PreviousGoogle WalletNextCredential delivery

Still stuck?

If this page did not answer it, the Help Center has the operational side of the same question — and a person reads what you send.

Go to the Help Center →

On this page

  • What you can see afterwards
  • Sending to many people
nomi

Digital credential infrastructure. Create, issue and manage credentials from the systems you already use.

Operated by

Country and currency

Platform

  • How it works
  • Templates
  • Lifecycle
  • Developers
  • Pricing
  • FAQ
  • Nomi Academic

Credentials

  • Memberships
  • Employee IDs
  • Student IDs
  • Events & loyalty

Developers

  • Documentation
  • Quick start
  • API reference
  • Webhooks
  • Integrations

Support

  • Help Center
  • Apple & Google Wallet
  • Verification
  • Contact support

Company

  • Request a demo
  • Talk to Nomi
  • Legal
  • Codingraph
PrivacyTermsCookiesSecurityContact

© 2026 Codingraph S.A. All rights reserved.

Nomi is a registered trademark used by Codingraph S.A. under licence.

Billed in USD

Apple Wallet and Google Wallet are trademarks of their respective owners.